MCP 使用指南

什么是 MCP？

MCP（Model Context Protocol）是一种标准化协议，用于将外部“能力”（如检索、搜索、文件访问、代码分析、第三方 API 等）以“服务器”的形式暴露给客户端（如 Chaterm）。 在 Chaterm 中，你可以连接多个 MCP 服务器，查看它们提供的“工具（Tools）”与“资源（Resources）”，并在聊天或工作流中按需调用这些能力。

快速开始

去哪里找 MCP 服务器

• GitHub 仓库：
  • modelcontextprotocol/servers
  • punkpeye/awesome-mcp-servers
• 在线 MCP 网站：
  • mcpservers.org
  • mcp.so
  • glama.ai/mcp/servers
• PulseMCP：www.pulsemcp.com

你可以从上述来源选择合适的服务器（例如文件系统、搜索、知识库、代码工具等）。

在 Chaterm 中新增 MCP 服务器

1. 在 Chaterm 中打开“设置”页面。
2. 找到左侧 工具与MCP Tab，点击 添加服务器，系统会自动打开 mcp_setting.json 文件。
3. 在编辑器中新增一段服务器配置（JSON）。
4. 保存后，Chaterm 会自动读取并尝试连接该服务器。

本地 MCP 服务器示例（stdio 类型）：

// MCP server using stdio transport
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

远程 MCP 服务器示例（Streamable HTTP 类型）：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "your-api-key"
      },
      "disabled": false
    }
  }
}

保存后：

• 你会看到该服务器项的状态徽标从“connecting”变为“connected”，或显示错误信息。
• 工具（Tools）与资源（Resources）将自动加载并显示数量。

配置项说明（新增服务器后建议对照检查）

对照项目中的 schemas.ts：

• 通用字段（两类都支持）：disabled?、timeout?（秒，默认值见应用）、autoApprove?（字符串数组）。
• type 可选：当提供了 command（推断为 stdio）或 url（推断为 http）时可省略；推荐显式填写以提高可读性。
• 兼容字段：支持 legacy transportType，应用会自动转换为 type；不建议在新配置中继续使用。

STDIO server configuration（本地命令行服务器）

字段	必需	说明	示例
type	否	连接类型，省略时会根据 command 推断为 stdio	"stdio"
command	是	启动可执行命令。可写为完整一行（含参数），或仅可执行名	"npx"、"node"、"python"
args	否	传递给命令的参数数组；当 command 含空格且未提供 args 时，系统会自动解析（支持引号与转义）	["-y", "@modelcontextprotocol/server-filesystem"]
cwd	否	进程工作目录	"/Users/you"
env	否	进程环境变量（键值对）	{"API_KEY": "xxx"}
disabled	否	是否禁用该服务器	true/false
timeout	否	调用超时时间（秒）	120、180
autoApprove	否	自动批准工具白名单（按工具名）	["read_file"]

说明：

• 不支持 envFile 字段；若需从文件加载变量，请在启动环境中自行处理后再写入 env。
• 兼容字段：为向后兼容，url?、headers? 在 stdio 配置里也被允许，但不建议使用（不会将连接类型切换为 http）。

HTTP server configuration（远程服务）

字段	必需	说明	示例
type	否	连接类型，省略时会根据 url 推断为 http	"http"
url	是	服务器地址（支持流式 HTTP 客户端）	"https://your-mcp-host.example.com/"
headers	否	请求头（如认证、代理相关）	{"Authorization": "Bearer <TOKEN>"}
disabled	否	是否禁用该服务器	true/false
timeout	否	调用超时时间（秒）	120、180
autoApprove	否	自动批准工具白名单（按工具名）	["search"]

说明：

• url 必须是合法的 URL（由 schema 强校验）。
• 兼容字段：为向后兼容，command?、args?、env? 在 http 配置里也被允许，仅用于旧配置迁移场景；不建议长期使用。

开发提示：文件变更与自动重启

• 若你本地以构建产物运行（例如 build/index.js），当该文件发生变更时，应用会检测到并尝试重启对应的 stdio 服务器，便于开发调试。
• 若未触发自动重启，可通过"禁用 → 启用"手动重连。

在对话中使用 MCP

工具开关

在 Tools 工具列表中点击工具名称即可启用/禁用该工具。已禁用的工具不会再加载到模型上下文中，Agent 无法再使用该工具。合理的关闭不需要使用的工具能极大的节省 token。

自动批准（auto-approval）

在配置中将工具名加入 autoApprove 后，匹配的工具将跳过确认直接执行。请仅对白名单内的可信工具启用。也可在工具执行过程中动态添加。

参数查看 & 资源浏览

展开工具的 PARAMETERS 折叠面板可查看参数名、是否必填与描述，便于在对话中正确提供参数。

在 Resources 中查看资源名称、描述与 URI；在支持的入口中可直接读取。

常用配置与安全建议

• 安全：仅为信任的工具添加到 autoApprove，谨慎注入含凭证的 env/headers。
• 性能：网络一般可将 timeout 设为 120 ～ 180；远端服务建议就近访问并确保代理对流式连接友好。
• 可维护性：统一命名与分组同类服务器，便于检索与排序；按需备份配置文件。

后续阅读

• 遇到连接/调用问题，或想了解安全/性能建议：请阅读《故障排除与最佳实践》。