@maplezzk/mcps 1.1.5 → 1.4.1

package/README.md

@@ -1,61 +1,60 @@
 # mcps - MCP CLI Manager
 
-[English](./README_EN.md) | [简体中文](./README.md)
+[English](./README.md) | [简体中文](./README.zh.md)
 
-一个用于管理和交互 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务的强大命令行工具。
+A powerful command-line interface for managing and interacting with [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers.
 
-## 功能特性
+## Features
 
-- 🔌 **服务管理**：轻松添加、移除、查看和更新 MCP 服务（支持 Stdio、SSE 和 HTTP 模式）
-- 🛠️ **工具发现**：查看已配置服务中所有可用的工具
-- 🚀 **工具执行**：直接在命令行调用工具，支持参数自动解析
-- 🔄 **守护进程**：保持与 MCP 服务的长连接，显著提高性能
-- 📊 **表格输出**：清晰的服务器状态和工具列表展示
-- 🔍 **工具筛选**：按关键词筛选工具，支持简洁模式
-- 🚨 **详细日志**：可选的详细日志模式，方便调试
-- ✅ **自动化测试**：完整的测试套件，确保代码质量
+- 🔌 **Server Management**: Easily add, remove, list, and update MCP servers (Stdio, SSE, and HTTP modes)
+- 🛠️ **Tool Discovery**: List available tools from any configured server
+- 🚀 **Tool Execution**: Call tools directly from the CLI with automatic argument parsing
+- 🔄 **Daemon Mode**: Maintain persistent connections to MCP servers for better performance
+- 📊 **Table Output**: Clear server status and tool listings
+- 🔍 **Tool Filtering**: Filter tools by keywords with simple mode
+- 🚨 **Verbose Logging**: Optional detailed logging for debugging
 
-## 安装
+## Installation
 
 ```bash
 npm install -g @maplezzk/mcps
 ```
 
-## 快速开始
+## Quick Start
 
 ```bash
-# 1. 添加一个服务
+# 1. Add a server
 mcps add fetch --command uvx --args mcp-server-fetch
 
-# 2. 启动守护进程
+# 2. Start the daemon
 mcps start
 
-# 3. 查看服务状态
+# 3. Check server status
 mcps status
 
-# 4. 查看可用工具
+# 4. List available tools
 mcps tools fetch
 
-# 5. 调用工具
+# 5. Call a tool
 mcps call fetch fetch url="https://example.com"
 ```
 
-## 使用指南
+## Usage Guide
 
-### 1. 守护进程 (Daemon Mode)
+### 1. Daemon Mode
 
-mcps 支持守护进程模式，可以保持与 MCP 服务的长连接，显著提高频繁调用的性能。
+mcps supports a daemon mode that maintains persistent connections to MCP servers, significantly improving performance for frequent calls.
 
-**启动守护进程：**
+**Start Daemon:**
 ```bash
-# 普通模式
+# Normal mode
 mcps start
 
-# 详细模式（显示每个服务器的连接过程和禁用的服务器）
+# Verbose mode (show connection process for each server and disabled servers)
 mcps start --verbose
 ```
 
-输出示例：
+Output example:
 ```
 Starting daemon in background...
 [Daemon] Connecting to 7 server(s)...
@@ -66,26 +65,26 @@ Starting daemon in background...
 Daemon started successfully on port 4100.
 ```
 
-**重启连接：**
+**Restart Connections:**
 ```bash
-# 重置所有连接
+# Reset all connections
 mcps restart
 
-# 仅重置特定服务的连接
+# Reset connection for a specific server
 mcps restart my-server
 ```
 
-**停止守护进程：**
+**Stop Daemon:**
 ```bash
 mcps stop
 ```
 
-**查看守护进程状态：**
+**Check Daemon Status:**
 ```bash
 mcps status
 ```
 
-输出示例：
+Output example:
 ```
 Daemon is running (v1.0.29)
 
@@ -98,14 +97,14 @@ gitlab-mr-creator   Connected   30
 Total: 3 connection(s)
 ```
 
-### 2. 服务管理 (Server Management)
+### 2. Server Management
 
-**查看所有服务（配置信息）：**
+**List all servers (configuration):**
 ```bash
 mcps ls
 ```
 
-输出示例：
+Output example:
 ```
 NAME                TYPE    ENABLED  COMMAND/URL
 ─────────────────   ──────  ───────  ─────────────
@@ -115,66 +114,66 @@ my-server           stdio   ✗        npx my-server
 Total: 3 server(s)
 ```
 
-**添加 Stdio 服务：**
+**Add Stdio Server:**
 ```bash
-# 添加本地 Node.js 服务
+# Add local Node.js server
 mcps add my-server --command node --args ./build/index.js
 
-# 使用 npx/uvx 添加服务
+# Use npx/uvx to add server
 mcps add fetch --command uvx --args mcp-server-fetch
 
-# 添加带环境变量的服务
+# Add server with environment variables
 mcps add my-db --command npx --args @modelcontextprotocol/server-postgres --env POSTGRES_CONNECTION_STRING="${DATABASE_URL}"
 ```
 
-**添加 SSE 服务：**
+**Add SSE Server:**
 ```bash
 mcps add remote-server --type sse --url http://localhost:8000/sse
 ```
 
-**添加 Streamable HTTP 服务：**
+**Add Streamable HTTP Server:**
 ```bash
 mcps add my-http-server --type http --url http://localhost:8000/mcp
 ```
 
-**移除服务：**
+**Remove Server:**
 ```bash
 mcps rm my-server
 ```
 
-**更新服务：**
+**Update Server:**
 ```bash
-# 刷新所有服务连接
+# Refresh all server connections
 mcps update
 
-# 更新特定服务的命令
+# Update specific server command
 mcps update my-server --command new-command
 
-# 更新特定服务的参数
+# Update specific server arguments
 mcps update my-server --args arg1 arg2
 
-# 同时更新命令和参数
+# Update both command and arguments
 mcps update my-server --command node --args ./new-build/index.js
 ```
 
-### 3. 工具交互 (Tool Interaction)
+### 3. Tool Interaction
 
-**查看服务下的可用工具：**
+**List available tools on a server:**
 ```bash
-# 详细模式（显示所有信息）
+# Detailed mode (show all information)
 mcps tools chrome-devtools
 
-# 简洁模式（只显示工具名称）
+# Simple mode (show only tool names)
 mcps tools chrome-devtools --simple
 
-# 筛选工具（按关键词）
+# Filter tools by keyword
 mcps tools chrome-devtools --tool screenshot
 
-# 多个关键词 + 简洁模式
+# Multiple keywords + simple mode
 mcps tools gitlab-mr-creator --tool file --tool wiki --simple
 ```
 
-详细模式输出示例：
+Detailed mode output example:
 ```
 Available Tools for chrome-devtools:
 
@@ -193,7 +192,7 @@ Available Tools for chrome-devtools:
     ...
 ```
 
-简洁模式输出示例：
+Simple mode output example:
 ```
 $ mcps tools chrome-devtools -s
 click
@@ -209,43 +208,43 @@ take_snapshot
 Total: 26 tool(s)
 ```
 
-**调用工具：**
+**Call Tools:**
 
-语法：
+Syntax:
 ```bash
 mcps call <server_name> <tool_name> [arguments...]
 ```
 
-- `<server_name>`: 已配置的 MCP 服务名称
-- `<tool_name>`: 要调用的工具名称
-- `[arguments...]`: 以 `key=value` 形式传递的参数。CLI 会尝试自动将值解析为 JSON（数字、布尔值、对象）。
+- `<server_name>`: Name of the configured MCP server
+- `<tool_name>`: Name of the tool to call
+- `[arguments...]`: Arguments passed as `key=value` pairs. The CLI attempts to automatically parse values as JSON (numbers, booleans, objects).
 
-示例：
+Examples:
 ```bash
-# 简单的字符串参数
+# Simple string argument
 mcps call fetch fetch url="https://example.com"
 
-# 带多个参数
+# Multiple arguments
 mcps call fetch fetch url="https://example.com" max_length=5000
 
-# JSON 对象参数
+# JSON object argument
 mcps call my-server createUser user='{"name": "Alice", "age": 30}'
 
-# 布尔值/数字参数
+# Boolean/number arguments
 mcps call chrome-devtools take_screenshot fullPage=true quality=90
 
-# 混合参数
+# Mixed arguments
 mcps call my-server config debug=true timeout=5000 options='{"retries": 3}'
 ```
 
-## 配置文件
+## Configuration File
 
-默认情况下，配置文件存储在：
+By default, the configuration file is stored at:
 `~/.mcps/mcp.json`
 
-您可以通过设置 `MCPS_CONFIG_DIR` 环境变量来更改存储位置。
+You can change the storage location by setting the `MCPS_CONFIG_DIR` environment variable.
 
-配置文件示例：
+Configuration file example:
 ```json
 {
   "servers": [
@@ -269,343 +268,74 @@ mcps call my-server config debug=true timeout=5000 options='{"retries": 3}'
 }
 ```
 
-## 环境变量
+## Environment Variables
 
-- `MCPS_CONFIG_DIR`: 配置文件目录（默认：`~/.mcps`）
-- `MCPS_PORT`: Daemon 端口（默认：`4100`）
-- `MCPS_VERBOSE`: 详细日志模式（默认：`false`）
+- `MCPS_CONFIG_DIR`: Configuration file directory (default: `~/.mcps`)
+- `MCPS_PORT`: Daemon port (default: `4100`)
+- `MCPS_VERBOSE`: Verbose logging mode (default: `false`)
 
-## 命令参考
+## Command Reference
 
-### 服务管理
-- `mcps ls` - 列出所有服务
-- `mcps add <name>` - 添加新服务
-- `mcps rm <name>` - 移除服务
-- `mcps update [name]` - 更新服务配置
+### Server Management
+- `mcps ls` - List all servers
+- `mcps add <name>` - Add a new server
+- `mcps rm <name>` - Remove a server
+- `mcps update [name]` - Update server configuration
 
-### 守护进程
-- `mcps start [-v]` - 启动守护进程（`-v` 显示详细日志）
-- `mcps stop` - 停止守护进程
-- `mcps status` - 查看守护进程状态
-- `mcps restart [server]` - 重启守护进程或特定服务
+### Daemon
+- `mcps start [-v]` - Start daemon (`-v` for detailed logging)
+- `mcps stop` - Stop daemon
+- `mcps status` - Check daemon status
+- `mcps restart [server]` - Restart daemon or specific server
 
-### 工具交互
-- `mcps tools <server> [-s] [-t <name>...]` - 查看可用工具
-  - `-s, --simple`: 只显示工具名称
-  - `-t, --tool`: 按名称筛选工具（可重复使用）
-- `mcps call <server> <tool> [args...]` - 调用工具
+### Tool Interaction
+- `mcps tools <server> [-s] [-t <name>...]` - List available tools
+  - `-s, --simple`: Show only tool names
+  - `-t, --tool`: Filter tools by name (can be used multiple times)
+- `mcps call <server> <tool> [args...]` - Call a tool
 
-## 性能优化
+## Performance
 
-mcps 通过以下方式优化性能：
+mcps optimizes performance through:
 
-1. **守护进程模式**：保持长连接，避免重复启动开销
-2. **工具缓存**：连接时缓存工具数量，避免重复查询
-3. **异步连接**：并行初始化多个服务器连接
+1. **Daemon Mode**: Maintains persistent connections, avoiding repeated startup overhead
+2. **Tool Caching**: Caches tool counts during connection, avoiding repeated queries
+3. **Async Connections**: Parallel initialization of multiple server connections
 
-典型性能：
-- 启动守护进程：10-15 秒（首次，取决于服务数量）
-- 查看状态：~200ms
-- 调用工具：~50-100ms
+Typical performance:
+- Start daemon: 10-15 seconds (first time, depends on server count)
+- Check status: ~200ms
+- Call tool: ~50-100ms
 
-## 开发工作流
+## FAQ
 
-欢迎贡献代码！以下是参与项目开发的完整流程。
-
-### 环境准备
-
-**前置要求：**
-- Node.js >= 20
-- npm >= 9
-- Git
-
-**克隆项目：**
-```bash
-git clone https://github.com/a13835614623/mcps.git
-cd mcps
-```
-
-**安装依赖：**
-```bash
-npm install
-```
-
-### 本地开发
-
-**开发模式（使用 ts-node 直接运行）：**
-```bash
-npm run dev -- <command>
-# 例如
-npm run dev -- ls
-npm run dev -- start
-```
-
-**构建项目：**
-```bash
-npm run build
-```
-
-**运行构建后的版本：**
-```bash
-npm start -- <command>
-# 或者
-node dist/index.js <command>
-```
-
-### 测试
-
-**运行测试：**
-```bash
-# 运行所有测试
-npm test
-
-# 监听模式（开发时推荐）
-npm run test:watch
-
-# 启动测试 UI 界面
-npm run test:ui
-
-# 生成测试覆盖率报告
-npm run test:coverage
-```
-
-**测试要求：**
-- 所有测试必须通过
-- 新功能需要添加相应的测试
-- 保持测试覆盖率在合理水平
-
-### 提交规范
-
-**提交信息格式：**
-```
-<type>: <description>
-
-[optional body]
-
-Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
-```
-
-**提交类型（type）：**
-- `feat`: 新功能
-- `fix`: 修复 bug
-- `chore`: 构建过程或辅助工具的变动
-- `docs`: 文档更新
-- `refactor`: 重构（既不是新增功能，也不是修复 bug）
-- `style`: 代码格式调整（不影响代码运行的变动）
-- `test`: 增加测试
-- `perf`: 性能优化
-
-**示例：**
-```bash
-feat: 支持可配置的 daemon 启动超时时间
-
-新增功能：
-- 支持通过命令行参数 --timeout/-t 设置超时
-- 支持通过环境变量 MCPS_DAEMON_TIMEOUT 设置超时
-- 支持通过配置文件 daemonTimeout 字段设置超时
-
-Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
-```
-
-### PR 流程
-
-**1. 创建功能分支：**
-```bash
-git checkout -b feature/your-feature-name
-# 或
-git checkout -b fix/your-bug-fix
-```
-
-**分支命名规范：**
-- `feature/` - 新功能
-- `fix/` - bug 修复
-- `refactor/` - 重构
-- `docs/` - 文档更新
-- `chore/` - 构建/工具更新
-
-**2. 开发并提交：**
-```bash
-# 进行开发...
-npm run build  # 确保构建成功
-npm test       # 确保测试通过
-
-# 提交代码
-git add .
-git commit -m "feat: 你的功能描述"
-```
-
-**3. 更新版本号（如需要）：**
-```bash
-# Patch 版本（bug 修复）
-npm version patch
-
-# Minor 版本（新功能）
-npm version minor
-
-# Major 版本（破坏性变更）
-npm version major
-```
-
-**4. 推送并创建 PR：**
-```bash
-git push origin feature/your-feature-name
-```
-
-然后访问 GitHub 创建 Pull Request，或在命令行使用：
-```bash
-gh pr create --title "feat: 功能标题" --body "PR 描述"
-```
-
-**5. PR 检查清单：**
-- ✅ CI 测试通过（GitHub Actions）
-- ✅ 代码通过所有测试
-- ✅ 新功能有对应的测试
-- ✅ 提交信息符合规范
-- ✅ PR 描述清晰说明了变更内容
-- ✅ 版本号已正确更新（如需要）
-
-**6. 解决冲突（如有）：**
-```bash
-# 如果 main 分支有更新，先合并最新代码
-git fetch origin
-git merge origin/main
-
-# 解决冲突后
-git add .
-git commit -m "chore: merge main and resolve conflicts"
-git push origin feature/your-feature-name
-```
-
-### 发布流程
-
-项目采用**自动化发布**流程：
-
-**1. 版本管理：**
-- 修改 `package.json` 中的版本号
-- 或使用 `npm version` 命令
-
-**2. 发布触发：**
-- 当 PR 合并到 `main` 分支时
-- 如果版本号发生变化
-- GitHub Actions 自动发布到 npm
-
-**3. 版本号规则：**
-- `1.0.0` → `1.0.1` (Patch): bug 修复
-- `1.0.1` → `1.1.0` (Minor): 新功能
-- `1.1.0` → `2.0.0` (Major): 破坏性变更
-
-**4. 预发布版本（可选）：**
-```bash
-npm version prerelease --preid beta
-# 生成 1.0.0-beta.0
-```
-
-预发布版本会发布到 npm 的 `beta` tag。
-
-**5. 跳过发布：**
-如果 PR 不需要发布，在标题中添加 `[skip release]`：
-```
-[skip release] chore: 更新文档
-```
-
-### CI/CD
-
-**CI 检查（.github/workflows/ci.yml）：**
-- 每次 PR 和 push 都会触发
-- 运行测试套件
-- 构建项目
-- 确保代码质量
-
-**Release 自动化（.github/workflows/release.yml）：**
-- PR 合并后触发
-- 检测版本号变化
-- 自动发布到 npm
-- 创建 GitHub Release
-
-### 代码规范
-
-**TypeScript：**
-- 使用 TypeScript 进行类型检查
-- 运行 `npm run build` 检查类型错误
-
-**代码风格：**
-- 遵循项目现有代码风格
-- 使用有意义的变量和函数名
-- 添加必要的注释
-
-**项目结构：**
-```
-mcps/
-├── src/
-│   ├── commands/      # 命令实现
-│   ├── core/          # 核心功能
-│   ├── types/         # 类型定义
-│   └── index.ts       # 入口文件
-├── test/              # 测试文件
-├── dist/              # 构建输出
-└── package.json
-```
-
-### 常见问题（开发）
-
-**Q: 如何调试代码？**
-```bash
-# 使用开发模式运行
-npm run dev -- start --verbose
-
-# 或构建后直接运行
-npm run build
-node --inspect dist/index.js <command>
-```
-
-**Q: 测试失败了怎么办？**
-```bash
-# 运行特定测试文件
-npm test -- <test-file>
-
-# 查看详细输出
-npm test -- --reporter=verbose
-```
-
-**Q: 如何本地测试 npm 包？**
-```bash
-# 在项目根目录
-npm link
-
-# 在其他项目中使用
-npm link @maplezzk/mcps
-mcps ls
-```
-
-## 常见问题
-
-**Q: 如何查看所有服务器的运行状态？**
+**Q: How to check the status of all servers?**
 ```bash
-mcps status  # 查看活跃连接
-mcps ls      # 查看所有配置（包括禁用的）
+mcps status  # Check active connections
+mcps ls      # Check all configurations (including disabled)
 ```
 
-**Q: 某个服务连接失败了怎么办？**
+**Q: What if a server fails to connect?**
 ```bash
-# 查看详细日志
+# View detailed logs
 mcps start --verbose
 
-# 重启该服务
+# Restart that server
 mcps restart my-server
 ```
 
-**Q: 如何临时禁用某个服务？**
-在配置文件中设置 `"disabled": true`，或使用 `mcps update` 修改配置。
+**Q: How to temporarily disable a server?**
+Set `"disabled": true` in the configuration file, or use `mcps update` to modify the configuration.
 
-**Q: 工具太多怎么快速找到？**
+**Q: How to quickly find tools when there are many?**
 ```bash
-# 筛选工具名称
+# Filter tools by keyword
 mcps tools my-server --tool keyword
 
-# 只显示名称
+# Show only names
 mcps tools my-server --simple
 ```
 
-## 许可证
+## License
 
 ISC

package/README.zh.md

@@ -0,0 +1,370 @@
+# mcps - MCP CLI Manager
+
+[English](./README.md) | [简体中文](./README.zh.md)
+
+一个用于管理和交互 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务的强大命令行工具。
+
+## 功能特性
+
+- 🔌 **服务管理**：轻松添加、移除、查看和更新 MCP 服务（支持 Stdio、SSE 和 HTTP 模式）
+- 🛠️ **工具发现**：查看已配置服务中所有可用的工具
+- 🚀 **工具执行**：直接在命令行调用工具，支持参数自动解析
+- 🔄 **守护进程**：保持与 MCP 服务的长连接，显著提高性能
+- 📊 **表格输出**：清晰的服务器状态和工具列表展示
+- 🔍 **工具筛选**：按关键词筛选工具，支持简洁模式
+- 🚨 **详细日志**：可选的详细日志模式，方便调试
+- ✅ **自动化测试**：完整的测试套件，确保代码质量
+
+## 安装
+
+```bash
+npm install -g @maplezzk/mcps
+```
+
+## 快速开始
+
+```bash
+# 1. 添加一个服务
+mcps add fetch --command uvx --args mcp-server-fetch
+
+# 2. 启动守护进程
+mcps start
+
+# 3. 查看服务状态
+mcps status
+
+# 4. 查看可用工具
+mcps tools fetch
+
+# 5. 调用工具
+mcps call fetch fetch url="https://example.com"
+```
+
+## 使用指南
+
+### 1. 守护进程 (Daemon Mode)
+
+mcps 支持守护进程模式，可以保持与 MCP 服务的长连接，显著提高频繁调用的性能。
+
+**启动守护进程：**
+```bash
+# 普通模式
+mcps start
+
+# 详细模式（显示每个服务器的连接过程和禁用的服务器）
+mcps start --verbose
+```
+
+输出示例：
+```
+Starting daemon in background...
+[Daemon] Connecting to 7 server(s)...
+[Daemon] - chrome-devtools... Connected ✓
+[Daemon] - fetch... Connected ✓
+[Daemon] - gitlab-mr-creator... Connected ✓
+[Daemon] Connected: 7/7
+Daemon started successfully on port 4100.
+```
+
+**重启连接：**
+```bash
+# 重置所有连接
+mcps restart
+
+# 仅重置特定服务的连接
+mcps restart my-server
+```
+
+**停止守护进程：**
+```bash
+mcps stop
+```
+
+**查看守护进程状态：**
+```bash
+mcps status
+```
+
+输出示例：
+```
+Daemon is running (v1.0.29)
+
+Active Connections:
+NAME                STATUS      TOOLS
+─────────────────   ──────────  ──────
+chrome-devtools     Connected   26
+fetch               Connected   1
+gitlab-mr-creator   Connected   30
+Total: 3 connection(s)
+```
+
+### 2. 服务管理 (Server Management)
+
+**查看所有服务（配置信息）：**
+```bash
+mcps ls
+```
+
+输出示例：
+```
+NAME                TYPE    ENABLED  COMMAND/URL
+─────────────────   ──────  ───────  ─────────────
+chrome-devtools     stdio   ✓        npx -y chrome-devtools-mcp ...
+fetch               stdio   ✓        uvx mcp-server-fetch
+my-server           stdio   ✗        npx my-server
+Total: 3 server(s)
+```
+
+**添加 Stdio 服务：**
+```bash
+# 添加本地 Node.js 服务
+mcps add my-server --command node --args ./build/index.js
+
+# 使用 npx/uvx 添加服务
+mcps add fetch --command uvx --args mcp-server-fetch
+
+# 添加带环境变量的服务
+mcps add my-db --command npx --args @modelcontextprotocol/server-postgres --env POSTGRES_CONNECTION_STRING="${DATABASE_URL}"
+```
+
+**添加 SSE 服务：**
+```bash
+mcps add remote-server --type sse --url http://localhost:8000/sse
+```
+
+**添加 Streamable HTTP 服务：**
+```bash
+mcps add my-http-server --type http --url http://localhost:8000/mcp
+```
+
+**移除服务：**
+```bash
+mcps rm my-server
+```
+
+**更新服务：**
+```bash
+# 刷新所有服务连接
+mcps update
+
+# 更新特定服务的命令
+mcps update my-server --command new-command
+
+# 更新特定服务的参数
+mcps update my-server --args arg1 arg2
+
+# 同时更新命令和参数
+mcps update my-server --command node --args ./new-build/index.js
+```
+
+### 3. 工具交互 (Tool Interaction)
+
+**查看服务下的可用工具：**
+```bash
+# 详细模式（显示所有信息）
+mcps tools chrome-devtools
+
+# 简洁模式（只显示工具名称）
+mcps tools chrome-devtools --simple
+
+# 筛选工具（按关键词）
+mcps tools chrome-devtools --tool screenshot
+
+# 多个关键词 + 简洁模式
+mcps tools gitlab-mr-creator --tool file --tool wiki --simple
+```
+
+详细模式输出示例：
+```
+Available Tools for chrome-devtools:
+
+- take_screenshot
+  Take a screenshot of the page or element.
+  Arguments:
+    format*: string (Type of format to save the screenshot as...)
+    quality: number (Compression quality from 0-100)
+    uid: string (The uid of an element to screenshot...)
+    ...
+
+- click
+  Clicks on the provided element
+  Arguments:
+    uid*: string (The uid of an element...)
+    ...
+```
+
+简洁模式输出示例：
+```
+$ mcps tools chrome-devtools -s
+click
+close_page
+drag
+emulate
+evaluate_script
+fill
+...
+take_screenshot
+take_snapshot
+
+Total: 26 tool(s)
+```
+
+**调用工具：**
+
+语法：
+```bash
+mcps call <server_name> <tool_name> [arguments...]
+```
+
+- `<server_name>`: 已配置的 MCP 服务名称
+- `<tool_name>`: 要调用的工具名称
+- `[arguments...]`: 以 `key=value` 形式传递的参数。CLI 会尝试自动将值解析为 JSON（数字、布尔值、对象）。
+
+示例：
+```bash
+# 简单的字符串参数
+mcps call fetch fetch url="https://example.com"
+
+# 带多个参数
+mcps call fetch fetch url="https://example.com" max_length=5000
+
+# JSON 对象参数
+mcps call my-server createUser user='{"name": "Alice", "age": 30}'
+
+# 布尔值/数字参数
+mcps call chrome-devtools take_screenshot fullPage=true quality=90
+
+# 混合参数
+mcps call my-server config debug=true timeout=5000 options='{"retries": 3}'
+```
+
+## 配置文件
+
+默认情况下，配置文件存储在：
+`~/.mcps/mcp.json`
+
+您可以通过设置 `MCPS_CONFIG_DIR` 环境变量来更改存储位置。
+
+配置文件示例：
+```json
+{
+  "servers": [
+    {
+      "name": "fetch",
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["mcp-server-fetch"]
+    },
+    {
+      "name": "my-server",
+      "type": "stdio",
+      "command": "node",
+      "args": ["./build/index.js"],
+      "env": {
+        "API_KEY": "${API_KEY}"
+      },
+      "disabled": false
+    }
+  ]
+}
+```
+
+## 环境变量
+
+- `MCPS_CONFIG_DIR`: 配置文件目录（默认：`~/.mcps`）
+- `MCPS_PORT`: Daemon 端口（默认：`4100`）
+- `MCPS_VERBOSE`: 详细日志模式（默认：`false`）
+
+## 命令参考
+
+### 服务管理
+- `mcps ls` - 列出所有服务
+- `mcps add <name>` - 添加新服务
+- `mcps rm <name>` - 移除服务
+- `mcps update [name]` - 更新服务配置
+
+### 守护进程
+- `mcps start [-v]` - 启动守护进程（`-v` 显示详细日志）
+- `mcps stop` - 停止守护进程
+- `mcps status` - 查看守护进程状态
+- `mcps restart [server]` - 重启守护进程或特定服务
+
+### 工具交互
+- `mcps tools <server> [-s] [-t <name>...]` - 查看可用工具
+  - `-s, --simple`: 只显示工具名称
+  - `-t, --tool`: 按名称筛选工具（可重复使用）
+- `mcps call <server> <tool> [args...]` - 调用工具
+
+## 性能优化
+
+mcps 通过以下方式优化性能：
+
+1. **守护进程模式**：保持长连接，避免重复启动开销
+2. **工具缓存**：连接时缓存工具数量，避免重复查询
+3. **异步连接**：并行初始化多个服务器连接
+
+典型性能：
+- 启动守护进程：10-15 秒（首次，取决于服务数量）
+- 查看状态：~200ms
+- 调用工具：~50-100ms
+
+
+## 开发工作流
+
+欢迎贡献代码！
+
+**快速开始：**
+```bash
+# 克隆项目
+git clone https://github.com/maplezzk/mcps.git
+cd mcps
+npm install
+
+# 开发模式
+npm run dev -- <command>
+
+# 构建和测试
+npm run build
+npm test
+```
+
+**重要规范：**
+- 不要直接在 `main` 分支提交代码
+- 使用 `npm version` 更新版本号（禁止手动修改）
+- 新功能必须包含单元测试
+
+📖 **完整开发文档**：[DEVELOPMENT.md](./DEVELOPMENT.md)
+
+
+## 常见问题
+
+**Q: 如何查看所有服务器的运行状态？**
+```bash
+mcps status  # 查看活跃连接
+mcps ls      # 查看所有配置（包括禁用的）
+```
+
+**Q: 某个服务连接失败了怎么办？**
+```bash
+# 查看详细日志
+mcps start --verbose
+
+# 重启该服务
+mcps restart my-server
+```
+
+**Q: 如何临时禁用某个服务？**
+在配置文件中设置 `"disabled": true`，或使用 `mcps update` 修改配置。
+
+**Q: 工具太多怎么快速找到？**
+```bash
+# 筛选工具名称
+mcps tools my-server --tool keyword
+
+# 只显示名称
+mcps tools my-server --simple
+```
+
+## 许可证
+
+ISC

package/dist/commands/call.js

@@ -1,6 +1,56 @@
 import chalk from 'chalk';
+import { readFileSync } from 'fs';
 import { configManager } from '../core/config.js';
 import { DaemonClient } from '../core/daemon-client.js';
+/**
+ * Parse call command arguments
+ * @param args - Command line arguments in key=value format
+ * @param raw - Whether to treat all values as raw strings
+ * @returns Parsed parameters object
+ */
+export function parseCallArgs(args, raw) {
+    const params = {};
+    if (!args)
+        return params;
+    args.forEach((arg) => {
+        const eqIndex = arg.indexOf('=');
+        if (eqIndex > 0) {
+            const key = arg.slice(0, eqIndex);
+            const valStr = arg.slice(eqIndex + 1);
+            if (raw) {
+                // --raw mode: treat all values as strings
+                params[key] = valStr;
+            }
+            else {
+                // Default mode: try JSON parsing
+                try {
+                    params[key] = JSON.parse(valStr);
+                }
+                catch {
+                    params[key] = valStr;
+                }
+            }
+        }
+    });
+    return params;
+}
+/**
+ * Load parameters from JSON string or file
+ * @param jsonValue - JSON string (starts with { or [) or file path
+ * @returns Parsed parameters object
+ */
+export function loadJsonParams(jsonValue) {
+    const trimmed = jsonValue.trim();
+    // Check if it's a JSON string (starts with { or [)
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return JSON.parse(jsonValue);
+    }
+    else {
+        // Treat as file path
+        const jsonContent = readFileSync(jsonValue, 'utf-8');
+        return JSON.parse(jsonContent);
+    }
+}
 function printResult(result) {
     if (result.content) {
         result.content.forEach((item) => {
@@ -22,6 +72,8 @@ function printResult(result) {
 export const registerCallCommand = (program) => {
     program.command('call <server> <tool> [args...]')
         .description('Call a tool on a server. Arguments format: key=value')
+        .option('-r, --raw', 'Treat all values as raw strings (no JSON parsing)')
+        .option('-j, --json <file>', 'Load parameters from a JSON file')
         .addHelpText('after', `
 Examples:
   $ mcps call my-server echo message="Hello World"
@@ -29,28 +81,33 @@ Examples:
   $ mcps call my-server config debug=true
   $ mcps call my-server createUser user='{"name":"Alice","age":30}'
 
+  # Use --raw to treat all values as strings
+  $ mcps call my-server createUser --raw id="123" name="Alice"
+
+  # Use --json to load parameters from a file
+  $ mcps call my-server createUser --json params.json
+
 Notes:
   - Arguments are parsed as key=value pairs.
-  - Values are automatically parsed as JSON if possible (numbers, booleans, objects).
-  - If JSON parsing fails, the value is treated as a string.
+  - By default, values are automatically parsed as JSON if possible (numbers, booleans, objects).
+  - Use --raw to disable JSON parsing and treat all values as strings.
+  - Use --json to load parameters from a JSON file or JSON string.
   - For strings with spaces, wrap the value in quotes (e.g., msg="hello world").
 `)
-        .action(async (serverName, toolName, args) => {
-        const params = {};
-        if (args) {
-            args.forEach((arg) => {
-                const eqIndex = arg.indexOf('=');
-                if (eqIndex > 0) {
-                    const key = arg.slice(0, eqIndex);
-                    const valStr = arg.slice(eqIndex + 1);
-                    try {
-                        params[key] = JSON.parse(valStr);
-                    }
-                    catch {
-                        params[key] = valStr;
-                    }
-                }
-            });
+        .action(async (serverName, toolName, args, options) => {
+        let params = {};
+        // Load from JSON file or string if specified
+        if (options.json) {
+            try {
+                params = loadJsonParams(options.json);
+            }
+            catch (error) {
+                console.error(chalk.red(`Failed to parse JSON: ${error.message}`));
+                process.exit(1);
+            }
+        }
+        else {
+            params = parseCallArgs(args, options.raw);
         }
         // Check if server exists in config first
         const serverConfig = configManager.getServer(serverName);

package/dist/commands/daemon.js

@@ -123,7 +123,8 @@ const startAction = async (options) => {
         env: {
             ...process.env,
             MCPS_DAEMON_DETACHED: 'true',
-            MCPS_VERBOSE: options.verbose ? 'true' : 'false'
+            MCPS_VERBOSE: options.verbose ? 'true' : 'false',
+            MCPS_CONNECTION_TIMEOUT: String((parseInt(options.connectionTimeout || process.env.MCPS_CONNECTION_TIMEOUT || '20', 10)) * 1000)
         }
     });
     subprocess.unref();
@@ -401,6 +402,7 @@ export const registerDaemonCommand = (program) => {
         .description('Start the daemon')
         .option('-p, --port <number>', 'Daemon port', String(DAEMON_PORT))
         .option('-t, --timeout <seconds>', 'Startup timeout in seconds (default: 30)')
+        .option('-c, --connection-timeout <seconds>', 'Server connection timeout in seconds (default: 20)')
         .option('-v, --verbose', 'Show detailed logs')
         .action((options) => startAction(options));
     program.command('stop')
@@ -423,6 +425,7 @@ export const registerDaemonCommand = (program) => {
     daemonCmd.command('start', { isDefault: true, hidden: true })
         .description('Start the daemon (default)')
         .option('-t, --timeout <seconds>', 'Startup timeout in seconds (default: 30)')
+        .option('-c, --connection-timeout <seconds>', 'Server connection timeout in seconds (default: 20)')
         .action((options) => startAction(options));
     daemonCmd.command('stop')
         .description('Stop the running daemon')

package/dist/core/pool.js

@@ -79,6 +79,8 @@ export class ConnectionPool {
         this.initializing = true;
         this.initialized = false;
         const verbose = process.env.MCPS_VERBOSE === 'true';
+        // 获取连接超时时间（从环境变量或默认 20 秒）
+        const connectionTimeout = parseInt(process.env.MCPS_CONNECTION_TIMEOUT || '20000', 10);
         // 过滤掉 disabled 的服务器
         const enabledServers = servers.filter(server => {
             const disabled = server.disabled === true;
@@ -98,7 +100,7 @@ export class ConnectionPool {
         for (const server of enabledServers) {
             process.stdout.write(`- ${server.name}... `);
             try {
-                await this.getClient(server.name, { timeoutMs: 8000 });
+                await this.getClient(server.name, { timeoutMs: connectionTimeout });
                 results.push({ name: server.name, success: true });
                 console.log('Connected ✓');
             }

package/dist/tests/unit/call.test.js

@@ -0,0 +1,111 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { parseCallArgs, loadJsonParams } from '../../commands/call.js';
+describe('call command', () => {
+    describe('parseCallArgs', () => {
+        it('should parse string values in default mode', () => {
+            const args = ['name=Alice', 'url=https://example.com'];
+            const result = parseCallArgs(args, false);
+            expect(result).toEqual({
+                name: 'Alice',
+                url: 'https://example.com'
+            });
+        });
+        it('should parse numbers and booleans in default mode', () => {
+            const args = ['count=10', 'active=true', 'score=3.14'];
+            const result = parseCallArgs(args, false);
+            expect(result).toEqual({
+                count: 10,
+                active: true,
+                score: 3.14
+            });
+        });
+        it('should parse JSON objects in default mode', () => {
+            const args = ['user={"name":"Alice","age":30}'];
+            const result = parseCallArgs(args, false);
+            expect(result).toEqual({
+                user: { name: 'Alice', age: 30 }
+            });
+        });
+        it('should treat all values as strings in raw mode', () => {
+            const args = ['id=123', 'count=10', 'active=true', 'pi=3.14'];
+            const result = parseCallArgs(args, true);
+            expect(result).toEqual({
+                id: '123',
+                count: '10',
+                active: 'true',
+                pi: '3.14'
+            });
+        });
+        it('should handle empty args', () => {
+            expect(parseCallArgs(undefined, false)).toEqual({});
+            expect(parseCallArgs([], false)).toEqual({});
+        });
+        it('should handle args without equals sign', () => {
+            const args = ['invalid', 'name=Alice', 'noequals'];
+            const result = parseCallArgs(args, false);
+            expect(result).toEqual({
+                name: 'Alice'
+            });
+        });
+        it('should handle values with equals sign', () => {
+            const args = ['equation=1+1=2', 'url=https://example.com?a=1&b=2'];
+            const result = parseCallArgs(args, false);
+            expect(result).toEqual({
+                equation: '1+1=2',
+                url: 'https://example.com?a=1&b=2'
+            });
+        });
+    });
+    describe('loadJsonParams', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = path.join(os.tmpdir(), `mcps-test-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`);
+            fs.mkdirSync(tempDir, { recursive: true });
+        });
+        afterEach(() => {
+            if (fs.existsSync(tempDir)) {
+                fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('should parse JSON string starting with {', () => {
+            const jsonStr = '{"key": "value", "number": 42}';
+            const result = loadJsonParams(jsonStr);
+            expect(result).toEqual({
+                key: 'value',
+                number: 42
+            });
+        });
+        it('should parse JSON string starting with [', () => {
+            const jsonStr = '[{"id": 1}, {"id": 2}]';
+            const result = loadJsonParams(jsonStr);
+            expect(result).toEqual([{ id: 1 }, { id: 2 }]);
+        });
+        it('should load and parse JSON from file', () => {
+            const testFile = path.join(tempDir, 'params.json');
+            const testData = { name: 'test', value: 123 };
+            fs.writeFileSync(testFile, JSON.stringify(testData));
+            const result = loadJsonParams(testFile);
+            expect(result).toEqual(testData);
+        });
+        it('should handle JSON string with leading/trailing whitespace', () => {
+            const jsonStr = '  {"key": "value"}  ';
+            const result = loadJsonParams(jsonStr);
+            expect(result).toEqual({ key: 'value' });
+        });
+        it('should throw error for invalid JSON string', () => {
+            expect(() => loadJsonParams('not valid json')).toThrow();
+        });
+        it('should throw error for non-existent file', () => {
+            const nonExistentFile = path.join(tempDir, 'non-existent.json');
+            expect(() => loadJsonParams(nonExistentFile)).toThrow();
+        });
+        it('should throw error for invalid JSON in file', () => {
+            const testFile = path.join(tempDir, 'invalid.json');
+            fs.writeFileSync(testFile, 'not valid json');
+            expect(() => loadJsonParams(testFile)).toThrow();
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maplezzk/mcps",
-  "version": "1.1.5",
+  "version": "1.4.1",
   "description": "A CLI to manage and use MCP servers",
   "publishConfig": {
     "access": "public"
@@ -16,7 +16,7 @@
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/a13835614623/mcps"
+    "url": "https://github.com/maplezzk/mcps"
   },
   "type": "module",
   "bin": {