/mcp - MCP 服务器管理

配置与管理 Claude Code 的模型上下文协议服务器

概述

/mcp 命令用于管理 Claude Code 的模型上下文协议(Model Context Protocol,简称 MCP)服务器。MCP 让 Claude Code 连接外部工具和数据源,扩展文件访问、平台集成与查询能力。

基本语法

/mcp <子命> [参数]

子命令

子命令描述
list列出已配置的 MCP 服务器
add添加 MCP 服务器
remove删除 MCP 服务器
enable启用 MCP 服务器
disable禁用 MCP 服务器
info显示 MCP 服务器信息
test测试 MCP 服务器连接

功能说明

通过 /mcp,Claude Code 可以:

  • 连接外部文件系统,访问更多项目文件。
  • 集成 GitHub 等代码托管平台。
  • 连接数据库与 API 服务。
  • 使用外部搜索工具。
  • 扩展 Claude Code 的功能范围。

使用场景

1. 列出已配置的 MCP 服务器

# 列出所有已配置的 MCP 服务器
/mcp list

2. 添加文件系统 MCP 服务器

# 添加本地文件系统访问
/mcp add filesystem stdio npx @modelcontextprotocol/server-filesystem /path/to/directory

3. 添加 GitHub MCP 服务器

# 添加 GitHub 集成
/mcp add github sse https://api.github.com/mcp --token $GITHUB_TOKEN

4. 测试 MCP 服务器连接

# 测试特定 MCP 服务器连接
/mcp test filesystem

# 测试所有 MCP 服务器
/mcp test --all

常见 MCP 服务器类型

1. 文件系统服务器

# 配置文件系统访问
/mcp add filesystem stdio npx @modelcontextprotocol/server-filesystem ~/projects

2. GitHub 服务器

# 配置 GitHub 集成
/mcp add github sse https://api.github.com/mcp --token $GITHUB_TOKEN

3. 数据库服务器

# 配置数据库连接
/mcp add database stdio npx @modelcontextprotocol/server-postgres --connection-string "postgresql://user:pass@localhost/db"

注意事项

  • MCP 服务器需要单独安装和配置。
  • 某些服务器需要 API 密钥或其他凭证。
  • 仅连接受信任的 MCP 服务器,避免数据泄露。
  • 性能取决于服务器类型与网络连接。

最佳实践

  • 只连接必要的 MCP 服务器,减少安全与性能开销。
  • 使用环境变量存储凭证,避免在命令中硬编码。
  • 定期测试连接,确保服务器持续可用。
  • 使用描述性名称,便于管理与识别。

总结

/mcp 命令是 Claude Code 扩展能力的重要入口。通过连接外部 MCP 服务器,你可以让 Claude Code 更高效地访问资源、集成平台并处理复杂任务。

On this page