概述

Model Context Protocol (MCP) 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。在 Claude Code 中配置 MCP 服务器可以显著扩展其能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。

本文将详细介绍 Claude Code 中 MCP 服务器的配置方法，帮助你快速搭建强大的 AI 开发环境。

配置文件位置和格式

配置文件位置

Claude Code 的 MCP 配置文件位于用户主目录下的 .claude 文件夹中：

macOS/Linux: ~/.claude/CLAUDE.md 或 ~/.claude/mcp.json
Windows: %USERPROFILE%\.claude\CLAUDE.md 或 %USERPROFILE%\.claude\mcp.json

注意: Claude Code 支持两种配置格式：Markdown 格式的 CLAUDE.md 和 JSON 格式的 mcp.json。推荐使用 mcp.json 进行结构化配置。

配置文件格式

mcp.json 格式

mcp.json 使用标准的 JSON 格式，包含 mcpServers 对象，其中每个键代表一个 MCP 服务器的配置：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": {
        "ENV_VAR": "value"
      }
    }
  }
}

CLAUDE.md 格式

CLAUDE.md 使用 Markdown 格式，在 YAML frontmatter 中配置 MCP 服务器...

问答

什么是 Model Context Protocol (MCP)？▼

MCP 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。

在 Claude Code 中配置 MCP 服务器有什么好处？▼

可以显著扩展 AI 的能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。

MCP 配置文件应该放在哪个目录下？▼

位于用户主目录下的 `.claude` 文件夹中。macOS/Linux 为 `~/.claude/`，Windows 为 `%USERPROFILE%\.claude\`。

Claude Code 支持哪些配置文件格式，推荐哪种？▼

支持 `CLAUDE.md` (Markdown) 和 `mcp.json` (JSON) 两种格式。推荐使用 `mcp.json` 进行结构化配置。

`mcp.json` 文件的基本结构包含哪些关键要素？▼

包含 `mcpServers` 对象，每个键代表一个服务器，配置项包括 `command`、`args` 和可选的 `env` 环境变量。

Claude Code MCP 服务器配置完全指南

概述