装之前要知道的事
每个 MCP 服务器启动时会向 Claude Code 注册一批工具。同时启用的服务器越多,注入上下文的工具列表就越长,会占用 token 并拖慢响应。 建议同时启用不超过 6 个服务器。 按当前项目需要启用,不用的暂时注释掉。 配置文件路径:| 客户端 | 配置文件路径 |
|---|---|
| Claude Desktop(macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop(Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor(项目级) | .cursor/mcp.json |
| Cursor(全局) | ~/.cursor/mcp.json |
1. Brave Search MCP — 实时网页搜索
让 Claude Code 能搜索最新信息,告别”知识截止日期”限制。 适用场景: 查最新文档、搜技术方案、了解某个库的最新版本。 获取 API Key: 在 Brave Search API 注册,免费计划每月 2000 次查询。2. Context7 MCP — 拉取最新库文档
Claude Code 的训练数据有截止日期,写代码时经常用到过时的 API。Context7 在每次对话时实时拉取对应库的最新官方文档,直接注入上下文。 适用场景: 用 Claude Code 写代码时,自动获取 React、Next.js、Tailwind 等库的最新 API 说明。use context7,Claude Code 会自动拉取相关库文档。
3. Filesystem MCP — 读写本地文件
让 Claude Code 直接访问你指定的本地目录,省去手动复制文件内容的步骤。 适用场景: 让 Claude Code 分析整个项目目录、批量修改文件、读取配置文件。4. GitHub MCP — 读取仓库、Issue、PR
让 Claude Code 直接访问 GitHub 仓库内容,无需手动复制代码或 Issue 描述。 适用场景: 让 Claude Code 分析仓库代码、总结 Issue、查看 PR diff、理解项目结构。 获取 Token: GitHub Settings → Developer settings → Personal access tokens → 创建,只需要repo 读权限。
5. Playwright MCP — 浏览器自动化
让 Claude Code 控制真实浏览器:打开网页、点击按钮、截图、填写表单。 适用场景: 自动化测试、网页截图、操作需要登录的页面、验证 UI 效果。6. Fetch MCP — 抓取任意网页内容
让 Claude Code 直接抓取并解析任意 URL 的内容,返回干净的文本。 适用场景: 读取文档页面、抓取竞品信息、解析 API 响应页面。uvx 需要先安装 uv:curl -LsSf https://astral.sh/uv/install.sh | sh完整配置示例
把上面的配置合并到一个文件里:推荐组合
不想全装?按使用场景选: 开发场景(3 件套)- Context7:拉取最新库文档
- Filesystem:读写本地项目目录
- GitHub:访问仓库代码和 Issue
- Brave Search:实时网页搜索
- Fetch:抓取静态页面内容
- Playwright:操控动态页面和截图
常见问题
配置保存后需要重启 Claude Desktop 吗?
配置保存后需要重启 Claude Desktop 吗?
需要完全退出再重启(macOS 需要从菜单栏退出,不只是关闭窗口)。重启后在新对话里才能使用新配置的 MCP 服务器。
如何确认 MCP 服务器已正常连接?
如何确认 MCP 服务器已正常连接?
打开 Claude Desktop,在新对话界面左下角或工具栏会显示已连接的 MCP 工具图标。也可以直接问 Claude:“你现在有哪些可用工具?”
npx 运行时报错找不到包怎么办?
npx 运行时报错找不到包怎么办?
确认 Node.js 版本 ≥ 18:
node --version。如果版本过低,用 nvm 升级:nvm install 20 && nvm use 20。某个 MCP 服务器启动失败怎么排查?
某个 MCP 服务器启动失败怎么排查?
打开 Claude Desktop 日志(macOS:
~/Library/Logs/Claude/),找对应服务器的错误信息。最常见的问题是环境变量没填或 API Key 错误。也可以用 MCP Inspector 单独测试某个服务器是否正常工作。需要把 MCP 服务器部署到远程 VPS 供多人共享使用?看 在 VPS 上部署远程 MCP 服务器。 本文最后更新于 2026-04,MCP 服务器版本以各仓库最新 release 为准。