ChainlessChain 文档

主题

MCP 服务器管理 (mcp) ​

Model Context Protocol 服务器配置、连接管理与工具调用。通过 MCP 协议扩展 AI 能力，连接外部工具和数据源。

核心特性 ​

  • 🔹 服务器配置: 添加、列出、删除 MCP 服务器配置
  • 🔹 连接管理: 连接/断开 MCP 服务器，支持会话保持
  • 🔹 工具发现: 列出已连接服务器提供的工具
  • 🔹 工具调用: 调用 MCP 工具并返回结果（文本/图片/JSON）
  • 🔹 JSON 输出: 多数子命令支持 --json 格式，便于脚本集成

系统架构 ​

mcp 命令 → mcp.js (Commander) → MCPClient / MCPServerConfig
                                       │
                  ┌──────────────┬──────┴──────┬──────────────┐
                  ▼              ▼             ▼              ▼
           servers/add/remove  connect     tools           call
                  │              │             │              │
                  ▼              ▼             ▼              ▼
            SQLite 配置存储  stdio 子进程  列出工具列表   执行工具并返回
                            连接保持复用   按服务器筛选   内容块（text/image）

命令参考 ​

bash
chainlesschain mcp servers                 # 列出已配置的服务器
chainlesschain mcp servers --json          # JSON 格式输出
chainlesschain mcp add <name> -c <cmd>     # 添加服务器配置
chainlesschain mcp remove <name>           # 删除服务器配置
chainlesschain mcp connect <name>          # 连接到服务器
chainlesschain mcp disconnect <name>       # 断开连接
chainlesschain mcp tools                   # 列出可用工具
chainlesschain mcp call <tool>             # 调用工具

子命令说明 ​

servers ​

列出所有已配置的 MCP 服务器，显示名称、命令、参数及自动连接状态。

bash
chainlesschain mcp servers
chainlesschain mcp servers --json

add ​

添加或更新一个 MCP 服务器配置。配置存储在本地数据库中。

bash
chainlesschain mcp add <name> -c <command> [-a <args>] [--auto-connect] [--json]
参数/选项说明
<name>服务器名称
-c, --command <cmd>服务器启动命令（必填）
-a, --args <args>命令参数，逗号分隔
--auto-connect启动时自动连接
--jsonJSON 格式输出

remove ​

删除一个已配置的 MCP 服务器。

bash
chainlesschain mcp remove <name>

connect ​

连接到一个已配置的 MCP 服务器。连接后会话保持，后续可直接调用工具。

bash
chainlesschain mcp connect <name> [--json]

disconnect ​

断开与 MCP 服务器的连接。

bash
chainlesschain mcp disconnect <name>

tools ​

列出当前已连接服务器提供的所有工具。可按服务器名称筛选。

bash
chainlesschain mcp tools
chainlesschain mcp tools -s <server-name>
chainlesschain mcp tools --json

call ​

调用指定的 MCP 工具。自动查找工具所在服务器，也可手动指定。

bash
chainlesschain mcp call <tool> [-s <server>] [-a <json-args>] [--json]
参数/选项说明
<tool>工具名称
-s, --server <name>指定服务器（可选，自动查找）
-a, --args <json>工具参数，JSON 格式
--jsonJSON 格式输出

关键文件 ​

  • packages/cli/src/commands/mcp.js — 命令实现
  • packages/cli/src/lib/mcp-client.js — MCP 客户端与服务器配置管理

安全考虑 ​

  • MCP 服务器以子进程方式启动，运行在本地环境中
  • 服务器配置（命令、参数）存储在本地 SQLite 数据库
  • API 密钥等敏感信息不应通过 --args 传递，建议使用环境变量
  • 连接保持为单例模式，进程结束后自动断开

使用示例 ​

场景 1：添加并连接文件系统 MCP 服务器 ​

bash
chainlesschain mcp add fs -c npx -a "-y,@modelcontextprotocol/server-filesystem,/home/user/docs"
chainlesschain mcp connect fs
chainlesschain mcp tools

添加一个基于 npm 包的文件系统 MCP 服务器，连接后查看可用工具。

场景 2：调用工具读取文件 ​

bash
chainlesschain mcp call read_file -a '{"path": "/home/user/docs/README.md"}'
chainlesschain mcp call read_file -a '{"path": "/tmp/data.json"}' --json

调用文件系统工具读取文件内容。--json 输出适合脚本处理。

场景 3：管理多个服务器 ​

bash
chainlesschain mcp add fs -c npx -a "-y,@modelcontextprotocol/server-filesystem" --auto-connect
chainlesschain mcp add github -c npx -a "-y,@modelcontextprotocol/server-github"
chainlesschain mcp servers --json
chainlesschain mcp remove github

配置多个服务器，--auto-connect 标记启动时自动连接，按需增删。

故障排查 ​

问题解决方案
Database not available先运行 chainlesschain db init 初始化数据库
Server not configured使用 chainlesschain mcp add 添加服务器配置
Connection failed检查命令和参数是否正确，确认 npx/node 可用
Tool not found先连接服务器：chainlesschain mcp connect <name>
工具调用超时检查 MCP 服务器进程是否正常运行

相关文档 ​

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team