2026-08-22 更新。 下面每一项都在当天按官方 MCP 参考服务器仓库和各厂商自己的文档重新核对过。这个生态里包名和托管端点变得很快:本文最初列出的几个参考服务器此后已被上游归档,这里一律换成了仍在维护的后继版本。请把这些代码片段当作有时间戳的快照,粘贴凭据之前先确认包名或 URL 仍然有效。如果你是第一次安装 Claude Code 本身,先看 Claude Code 配置指南。
MCP——Model Context Protocol——把 Claude Code 从「读写文件的 agent」升级成「能跟你的数据库、监控、工单、库文档和整套技术栈对话的 agent」。协议落地近两年,生态稳定下来一批「第一天就值得装」的服务器,加一长串小众的。
这篇文章是 day-one 短名单:九个真正能扩展 Claude Code 能力边界的 MCP server,每个一段背景、一段安装代码、一个真实使用例子。没有一个是 hello world——都是我们以及和我们打交道的开发者 2026 年实际在用的。
快速回顾:MCP 是什么
MCP 是一个小型 JSON-RPC 协议——最初由 Anthropic 推出,现已是开放标准——标准化了 agent 访问外部工具的方式。MCP server 通过 stdio 或 HTTP 暴露 tools(可调用函数)、resources(可读 URI)、prompts(模板)。Claude Code 会读取你注册的 server——项目范围的在仓库根目录的 .mcp.json,用户范围和本地范围的在 ~/.claude.json——启动或连接它们,它们暴露的工具自动出现在 agent 的工具列表里。
下面所有 server 只有两种安装形态。本地(stdio)server 是由 Claude Code 启动的进程:claude mcp add <name> -- npx -y <package>。远程(HTTP)server 是一个你去连接的 URL,通常在 Claude Code 内完成 OAuth 授权:claude mcp add --transport http <name> <url>。两种形态都可以加 --scope user,让 server 在所有项目里可用,而不只是当前项目。下面的 JSON 片段是等价的 mcpServers 条目,习惯手改文件的话可以直接用。
国内特定问题(在屏蔽 PyPI / npm registry 的网络下跑 MCP server)见 国内使用 Claude Code 完整指南。
下面九个按「我们多久会用一次」大致排序。
1. Filesystem(@modelcontextprotocol/server-filesystem)
多数人装的第一个 MCP server,也仍然是官方维护的参考服务器之一。在 Claude Code 工作目录之外暴露范围受限的文件读写搜索。当 agent 需要读 ~/Documents 写汇报、看 /etc/ 下的配置、在多个项目之间搬文件时有用。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/me/Documents",
"/Users/me/projects"
]
}
}
}
真实使用:「找出我 projects 目录下所有 docker-compose.yml,告诉我哪些还在用废弃的 v2 语法。」Agent 遍历文件系统、打开每个、汇报。
2. Git(mcp-server-git)
Claude Code 本来就读文件;Git MCP 加上一类对 commit 历史、blame、diff、bisect 的一等公民操作。把很多 git shell 调用替换成结构化工具调用,Claude 组合得更稳。这个是参考服务器仓库里的 Python 包,所以用 uvx 而不是 npx 安装。
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git"]
}
}
}
真实使用:「找到限流中间件从内存切到 Redis 的那次 commit。总结 diff,列出它动过的每个文件。」Agent 一气通过 git log、git show 把链路串起来,不用你来回贴 hash。
3. GitHub(github/github-mcp-server)
原来的参考服务器 GitHub 包已归档;现在由 GitHub 自己维护官方 server,能拉 issue、PR、分支、workflow run 和代码搜索。最省事的是托管端点,在 Claude Code 内用 OAuth 授权——本地不留 token:
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
想用 personal access token 在本地跑的话,同一个 server 也有 Docker 镜像:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
}
}
}
}
真实使用:「看下这个 repo 最近 10 个已关闭 PR。哪些动了 auth 模块?这些里面,总结 review 评论——有没有提出但没解决的担忧?」
4. Postgres(postgres-mcp)
已归档的参考 Postgres server 有一个仍在维护的后继:Postgres MCP Pro。它加了 schema 反查、索引与查询计划分析,以及对安全最要紧的一点——显式的 --access-mode=restricted 参数,把整个会话锁成只读。配只读副本连接串,agent 能回答数据问题,却永远改不了一行。
{
"mcpServers": {
"postgres": {
"command": "uvx",
"args": ["postgres-mcp", "--access-mode=restricted"],
"env": {
"DATABASE_URI": "postgresql://reader@localhost:5432/mydb"
}
}
}
}
真实使用:「我们三周前加了 subscription_tier 列。还有行是 NULL 的吗?如果有,能从 join 看出是哪类用户群吗?」Agent 检查 schema、跑查询、把上下文串起来。
5. Context7(托管 https://mcp.context7.com/mcp)
Agent 写错代码最常见的原因是库知识过时——某个 API 在模型训练截止之后改了。Context7 把你点名的库的当前版本文档直接拉进上下文,「按 Next.js 16 的 proxy 约定写」就会对着今天的文档解析,而不是去年的。它是托管 server,用 API key 作为 bearer header 鉴权:
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header "Authorization: Bearer <your-context7-key>"
真实使用:「写中间件之前,先拉 Next.js 关于 proxy.ts 的最新文档,确认 matcher 语法。然后再实现。」省掉 agent 猜旧签名、反复重试的循环。
6. Linear(托管 https://mcp.linear.app/mcp)
工单是工作真正发生的地方,把 Linear 拉进 Claude Code 关上一个大的上下文缺口。社区的 linear-mcp 包已被 Linear 官方托管 server 取代,用 OAuth 授权:
claude mcp add --transport http linear https://mcp.linear.app/mcp
只读版本在 https://mcp.linear.app/mcp/readonly——agent 只该读工单、不该改工单时用它。
真实使用:「我接手 ENG-1432。把整个工单、关联的设计文档、相关 issue、最近的评论拉过来。总结到底要做什么。」
7. Playwright(@playwright/mcp)
参考 Puppeteer server 已归档;微软的 Playwright MCP 是仍在维护的浏览器操作 server。它基于无障碍树而不是截图工作,token 更省、点中正确元素也更稳。访问 URL、点击、填表、截图、抓取需要 JS 执行的内容。
claude mcp add playwright npx @playwright/mcp@latest
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
真实使用:「打开 staging 站点,用测试用户登录,导航到 billing,截图。生产也来一遍。两张图 diff。」给 Claude Code 真正的端到端测试能力。
8. 网页搜索(@brave/brave-search-mcp-server 或 Tavily)
Web 也是上下文的一部分。搜索 MCP 让 agent 在不让你 copy-paste 进 prompt 的情况下找到当下信息。参考 Brave server 已归档,换成 Brave 官方包;不想本地跑进程的话,Tavily 提供托管端点。
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": { "BRAVE_API_KEY": "BSA..." }
}
}
}
Tavily 托管版:claude mcp add --transport http tavily "https://mcp.tavily.com/mcp/?tavilyApiKey=<your-tavily-key>"。
真实使用:「AWS API Gateway 当下的并发请求上限是多少?找官方文档链接。」比 Claude 靠训练截止日期猜更快、更诚实。
9. Sentry(托管 https://mcp.sentry.dev/mcp)
把生产错误直接喂给 agent。Sentry 官方 server 是托管的、用 OAuth 授权,不用管任何 auth token:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
第一次你说「看下最新的 Sentry 错误,告诉我哪些可能跟 PR #1234 有关」时,你就理解这一项为什么在名单上。
真实使用:「拉过去 24 小时未解决的 top 10 错误。按可能原因分组。每个根据 stack trace 推测可能涉及的文件。」
备选
几个差点进短名单但值得知道的:
- Notion / Confluence —— 拉内部文档。Notion 有托管 server:
https://mcp.notion.com/mcp。设计文档和历史决策上特别有用。 - Figma —— 读 frame 和组件定义。配前端 agent 把设计翻译成代码。
- JetBrains IDE —— 从 Claude Code 控制 IntelliJ/PyCharm。受益于 IDE 检查的重构流有用。
- Memory(
@modelcontextprotocol/server-memory)—— 参考服务器,给 agent 一个跨 session 的持久知识图谱。长期项目值得。 - Slack —— 参考 server 已归档;社区 fork 在接着维护,交 bot token 之前先看看维护状态。
- MongoDB / Redis —— 相当于 Postgres server 的非关系版,给数据层其他部分用。
关于信任和权限
MCP server 拿着你给它的凭据运行。几条经验法则:
- 尽量用只读凭据。Postgres 例子用 restricted 模式加 reader 用户;Linear 有只读端点;GitHub token 可以限定为私有 repo 的只读。
- 优先选带 OAuth 的托管 server,而不是把长期 token 写进 JSON 文件:token 不落盘,撤销授权在厂商那边点一下就行。
- 审一遍每个 server 暴露什么再大规模装。
npx @modelcontextprotocol/inspector打开 MCP Inspector,连上 server 后列出它注册的全部工具;在 Claude Code 里,/mcp会显示每个已连接 server 的工具数量。 - 不要在开发机上跑生产凭据。生产数据 agent 应该把 MCP server 跑在生产环境里,让 Claude Code 通过 HTTP MCP 而非 stdio 通信。
- 对做破坏性操作的工具特别小心——DELETE 查询、
rm -rf、强推。要么用只读模式,要么外面包一层确认 prompt。
配置技巧
- 配置文件位置:团队通过版本控制共享的项目范围 server 放仓库根目录的
.mcp.json(Claude Code 首次使用时会让你确认批准);用户范围(所有项目可用)和本地范围(只属于单个项目)的 server 都在~/.claude.json。用claude mcp add … --scope user会自动写到对的位置。 - 验证 server 跑起来:
claude mcp list逐个打印健康状态;在 Claude Code 里,/mcp列出已连 server、处理远程 server 的 OAuth 登录,启动失败的会显示出来。 - 国内:基于 npx 的安装可能因 npm registry 延迟卡住。要么
npmrc配国内镜像,要么先全局装一次 server 包再引本地路径。托管 server 完全绕开 registry。详见 国内使用 Claude Code 完整指南。
常见问题
九个都要装吗? 不用。挑三四个匹配你工作真正接触的外部系统。后端 TypeScript 工程师常用 filesystem、git、GitHub、Postgres,加 Linear/Context7 之一。前端可能选 Figma 和 Playwright。
会不会拖慢 Claude? 每个 stdio server 是一个进程;一打加上启动时间和内存。本地 server 15 个以上有明显感觉;8 个以下基本无感。托管的 HTTP server 本地零开销,这也是优先选它们的又一个理由。
怎么自己写? 协议很小。TypeScript 和 Python 官方 SDK 文档完善。一个有用的内部模式是把自己的内部 HTTP API 包成 MCP server——大约 80 行 TypeScript。
Codex CLI 能用吗?
能。Codex CLI 同样支持 MCP server:stdio server 用 codex mcp add <name> -- <command>,或者在 ~/.codex/config.toml 里写 [mcp_servers.<name>] 表,streamable HTTP 和 OAuth 都支持。上面大部分 server 在两个客户端里都能原样用。两个 CLI 都在跑的话,见 Codex CLI 平替方案指南 了解怎么让它们的花费落在同一把 Key 上。
MCP server 能上网吗? 能——它们就是普通进程或远程服务。搜索和 web 类 server 显式就是这么做的。对敏感场景,按需给本地 server 做网络隔离。
Cursor 或其他客户端的 MCP 怎么样?
Cursor 从 2025 年初起就支持 MCP:读 .cursor/mcp.json(项目)或 ~/.cursor/mcp.json(全局),支持 stdio 和带 OAuth 的 HTTP,所以上面的 server 在那边也能用。差别在客户端侧的配套——Claude Code 多了对共享 .mcp.json 的项目范围审批、插件自带的 server,以及从 /mcp 面板完成 OAuth 登录。
结论
MCP 是「读文件的 Claude Code」和「碰得到你整个技术栈的 Claude Code」之间的差别。从 filesystem + git + GitHub + Postgres 起步;按你的工作流叠加其他。复合效应——每个 MCP server 都让其他 server 的能力倍增——让 agent 月月感觉更有用。
如果你要把多个装了 MCP 的 agent 接进同一条工作流,顺序、并行、层级、人工介入这些模式层面的取舍,见多 Agent 编排的常见模式。
Claude Code 本身配置见 Claude Code 配置指南;LLM API 网关如何位于你的编排框架之下,见 生产环境 AI Agent 完整指南。