Claude MCP(Model Context Protocol)是Claude AI与外部系统交互的核心协议,它允许Claude通过标准化方式连接各种外部服务和数据源。本文将介绍claude mcp命令的使用方法,帮助您轻松管理MCP服务器。

list:查看已配置的MCP服务器

list命令用于列出当前已配置的所有MCP服务器及其状态。

claude mcp list

执行后会显示所有MCP服务器的健康状态,例如:

Checking MCP server health...
context7: npx -y @upstash/context7-mcp --api-key ctx7sk-*******-*****-****-****-************ - ✓ Connected
serena: uvx --from /home/arnold/share/mcp_tools/serena_mcp/serena serena start-mcp-server --context ide-assistant --project /userdata/20250901_github_projects/ai-chatrooms - ✓ Connected

该命令会检查每个MCP服务器的连接状态,显示"✓ Connected"表示服务器已成功连接。

get:获取MCP服务器详细信息

get命令用于查看特定MCP服务器的详细配置信息。

claude mcp get <服务器名称>

例如:

claude mcp get context7

输出示例:

context7:
Scope: Local config (private to you in this project)
Status: ✓ Connected
Type: stdio
Command: npx
Args: -y @upstash/context7-mcp --api-key ctx7sk-****
Environment:
To remove this server, run: claude mcp remove "context7" -s local

该命令显示了服务器的作用域、连接状态、类型、执行命令、参数和环境变量等关键信息。

add:添加新的MCP服务器

add命令用于添加新的MCP服务器。

claude mcp add [选项] <名称> <命令或URL> [参数...]

例如添加一个文件系统访问服务器:

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /home/arnold/Documents

该命令会将新服务器添加到配置中,但需要指定作用域(默认为本地作用域)。

remove:移除MCP服务器

remove命令用于删除已配置的MCP服务器。

claude mcp remove [选项] <名称>

例如:

claude mcp remove context7 -s local

-s参数指定作用域:

  • local:本地作用域(默认)
  • user:用户全局作用域

add-json:通过JSON添加MCP服务器

add-json命令允许通过JSON字符串直接添加MCP服务器配置,特别适合复杂配置。

claude mcp add-json <名称> <JSON字符串>

示例:

claude mcp add-json tavily-mcp '{"command":"cmd","args":["/c","npx","-y","tavily-mcp@0.1.4"],"env":{"TAVILY_API_KEY":"你的API密钥"},"alwaysAllow":["tavily-search","tavily-extract"],"disabled":false}'

该命令可以一次性设置所有配置项,包括命令、参数、环境变量和权限。

serve:启动Claude Code MCP服务器

serve命令用于启动Claude Code的MCP服务器。

claude mcp serve [选项]

该命令通常用于开发MCP服务器时启动服务端,让Claude能够连接到本地开发的MCP服务器。

add-from-claude-desktop:从Claude Desktop导入MCP服务器

claude mcp add-from-claude-desktop [选项]

此命令仅限于Mac和WSL(Windows Subsystem for Linux)系统使用,用于将Claude Desktop中配置的MCP服务器导入到Claude Code中。

claude mcp add-from-claude-desktop

reset-project-choices:重置项目级MCP服务器选择

claude mcp reset-project-choices

该命令会重置当前项目中所有已批准和拒绝的项目级MCP服务器(.mcp.json配置),允许您重新选择和配置MCP服务器。

MCP服务器作用域详解

理解作用域对于正确配置MCP服务器至关重要:

  1. Local作用域(默认):仅在当前目录可用,配置存储在项目根目录的.mcp.json文件中
  2. User作用域:在所有项目中都可用,使用-s user标志添加

例如,添加一个全局可用的GitHub服务器:

claude mcp add github npx -y @modelcontextprotocol/server-github -s user

通过合理使用这些命令,您可以轻松地将Claude与各种外部工具和数据源集成,大大扩展Claude的能力,使其成为更强大的AI助手。无论是访问本地文件系统、与GitHub交互,还是使用第三方API,Claude MCP都能提供简单高效的解决方案。

附:claude mcp --help

root@arnold:/userdata/20250901_github_projects/ai-chatrooms# claude mcp -h
Usage: claude mcp [options] [command]

Configure and manage MCP servers

Options:
  -h, --help                                     Display help for command

Commands:
  serve [options]                                Start the Claude Code MCP server
  add [options] <name> <commandOrUrl> [args...]  Add a server
  remove [options] <name>                        Remove an MCP server
  list                                           List configured MCP servers
  get <name>                                     Get details about an MCP server
  add-json [options] <name> <json>               Add an MCP server (stdio or SSE) with a JSON string
  add-from-claude-desktop [options]              Import MCP servers from Claude Desktop (Mac and WSL only)
  reset-project-choices                          Reset all approved and rejected project-scoped (.mcp.json) servers within this project
  help [command]                                 display help for command
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐