MCP 插件安装指南
了解如何安装和配置 MCP（模型上下文协议）服务器，通过外部工具、数据源和集成服务扩展 Claude 的能力。
模型上下文协议（MCP）是由 Anthropic 创建的开放标准，用于规范 AI 模型与外部数据源和工具的连接方式。MCP 常被比喻为"AI 的 USB-C"，它为 Claude 提供了一个通用接口，使其能够与本地文件、数据库、API 和开发工具进行交互。
截至 2026 年，MCP 已获得 Anthropic、OpenAI、Google 和 Microsoft 的支持，成为 AI 智能体事实上的集成标准。目前生态系统中已有 593+ 个 MCP 服务器可用，涵盖 Anthropic 官方包和社区构建的集成。
前置条件
Node.js（LTS 版本）
大多数 MCP 服务器需要通过 npx 运行。请从 nodejs.org 下载安装。
Python / uv（可选）
部分 MCP 服务器基于 Python 开发，使用 uvx 代替 npx。
Claude Desktop
需要安装 Claude Desktop 桌面应用程序，支持 macOS 和 Windows。
无需付费订阅
MCP 服务器适用于所有 Claude 方案，包括免费版。
配置文件位置
MCP 服务器在 claude_desktop_config.json 文件中进行配置。该文件的位置取决于你的操作系统：
~/Library/Application Support/Claude/claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json 提示
你不需要手动创建此文件。Claude Desktop 可以为你自动生成——请参阅下方的安装步骤。
分步安装教程
启动 Claude Desktop
在电脑上打开 Claude Desktop 应用程序。
打开设置
点击菜单按钮 → File → Settings（或使用键盘快捷键）。
进入开发者选项卡
在设置面板中，点击左侧边栏的 "Developer" 选项卡。
点击"Edit Config"
这将在默认文本编辑器中打开（或创建）claude_desktop_config.json 文件。
添加 MCP 服务器配置
在 mcpServers 键下添加你需要的 MCP 服务器（参见下方配置格式说明）。
保存并重启
保存配置文件并完全重启 Claude Desktop，使更改生效。
验证安装
在 Claude Desktop 界面中查找锤子图标 🔨。点击它可以查看所有可用的 MCP 工具。
配置格式
配置文件使用简单的 JSON 结构。每个 MCP 服务器定义在 mcpServers 键下：
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "@package/server-name"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-brave-api-key"
}
}
}
}热门 MCP 服务器
以下是生态系统中最常用的 MCP 服务器：
| 服务器 | 包名 | 用途 |
|---|---|---|
| Filesystem | @modelcontextprotocol/server-filesystem | 读写本地文件、创建文档、管理文件夹 |
| GitHub | @modelcontextprotocol/server-github | 读取代码库、查看 PR、跟踪工作流 |
| PostgreSQL | @modelcontextprotocol/server-postgres | 只读数据库访问，支持 Schema 检查 |
| Brave Search | @modelcontextprotocol/server-brave-search | 网络搜索功能 |
| Puppeteer | @modelcontextprotocol/server-puppeteer | 浏览器自动化与网页抓取 |
| Sequential Thinking | @modelcontextprotocol/server-sequential-thinking | 动态推理与逐步问题求解 |
| Slack | @anthropic/mcp-server-slack | Slack 工作区集成 |
| Google Drive | @anthropic/mcp-server-gdrive | Google Docs、Sheets 和 Drive 集成 |
| Docker | @anthropic/mcp-server-docker | 容器管理与编排 |
| Memory | @modelcontextprotocol/server-memory | 跨会话持久化记忆 |
传输协议
MCP 支持不同的传输机制，用于 Claude 与 MCP 服务器之间的通信：
stdio（标准输入/输出）
Claude Desktop 的默认传输方式。客户端将 MCP 服务器作为本地进程启动，并通过 stdin/stdout 进行通信。配置中的 command 和 args 字段即定义了此方式。
StreamableHTTP
推荐用于 Web 和远程访问的协议。支持多个并发客户端，是已弃用的 SSE 传输的继任者。
language 适用于远程/Web 服务器SSE (Server-Sent Events)
已弃用，推荐使用 StreamableHTTP 替代。新集成请勿使用此协议。
安全注意事项
重要提醒
MCP 服务器在本地运行，可以访问你的系统。2026 年 1 月，Anthropic 官方 Git MCP 服务器中发现了严重漏洞。请务必遵循安全最佳实践。
仅从可信来源安装 — 使用 Anthropic 官方包或维护活跃的知名社区服务器。
保持服务器更新 — 定期运行 npx @package/server-name 以获取最新的安全补丁。
使用环境变量存储密钥 — 切勿在配置文件中直接硬编码 API 密钥。请使用 env 字段或系统环境变量。
限制文件系统访问范围 — 使用文件系统服务器时，仅授权访问你实际需要的特定目录。
移除未使用的服务器 — 每个 MCP 服务器都会增加攻击面。请移除不再使用的服务器。
故障排除
重启后锤子图标未出现 expand_more
这通常意味着配置文件存在 JSON 语法错误。常见问题包括：
- 服务器条目之间缺少或多余逗号
- 括号或花括号不匹配
- 使用了单引号而非双引号
可在 jsonlint.com 验证你的 JSON，或使用 node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"
MCP 服务器启动失败 expand_more
请检查以下几点：
- 确保已安装 Node.js 且
npx在系统 PATH 中可用 - 尝试在终端中手动运行 npx 命令以查看错误输出
- 检查包名是否正确（拼写错误很常见）
- 对于需要 API 密钥的服务器，请确认密钥有效且已正确设置在
env字段中
权限被拒绝错误 expand_more
MCP 服务器继承 Claude Desktop 进程的权限：
- 在 macOS 上，检查系统设置 → 隐私与安全性中的相关权限
- 确保配置中指定的目录对你的用户账户可访问
- 对于文件系统服务器，验证
args中的路径是否存在且可读
探索 MCP 生态系统
目前已有 593+ 个 MCP 服务器可用，几乎涵盖各种使用场景。你可以在 modelcontextprotocol.io 浏览官方 MCP 服务器目录，或在 GitHub 上查看社区精选列表以获取最新资源。