Logo Vincent
返回文章列表

Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具

Claude
Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具

什么是 /mcp

用 Claude Code 写代码的时候，你可能遇到过这样的情况：

  • 想让 Claude Code 直接查数据库，但它访问不了
  • 想让它帮你操作 GitHub issue，但它只能用 gh 命令行
  • 想让它读取 Confluence 或 Notion 里的文档，但它够不着

Claude Code 本身的能力是有边界的——它能读写本地文件、执行 shell 命令，但对于外部服务和数据源，它就束手无策了。

这就是 /mcp 命令的用武之地。

/mcp 是 Claude Code 的一个斜杠命令，用来管理 MCP（Model Context Protocol）服务器。MCP 服务器就像”插件”，能让 Claude Code 连接到各种外部工具和数据源，获得原本不具备的能力。

先搞懂 MCP 是什么

MCP 全称是 Model Context Protocol（模型上下文协议），是 Anthropic 推出的一个开放标准。

你可以把它理解为 AI 的 USB 接口——一个统一的协议，让 AI 模型能够连接各种外部工具和数据源。有了 MCP，Claude Code 就不再局限于本地文件和 shell 命令，而是可以和数据库、API、云服务等各种系统对话。

一个 MCP 服务器本质上就是一个小程序，它：

  1. 实现了 MCP 协议
  2. 提供了一组特定的工具（比如”查询数据库”、“创建 GitHub issue”）
  3. Claude Code 通过协议调用这些工具，就像调用自己内置的工具一样

MCP 架构：Claude Code 通过 MCP 协议连接外部服务

怎么用

查看已配置的 MCP 服务器

在 Claude Code 交互模式下输入：

/mcp

会列出当前所有已配置的 MCP 服务器及其状态。

添加 MCP 服务器（命令行）

在终端中使用 claude mcp add 命令：

claude mcp add <名称> <启动命令> [参数...]

比如，添加一个文件系统 MCP 服务器：

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /path/to/dir

用 JSON 添加（更灵活）

如果需要配置环境变量等复杂选项，可以用 add-json：

claude mcp add-json github-server '{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_TOKEN": "your-token-here"
  }
}'

删除 MCP 服务器

claude mcp remove <名称>

列出所有服务器

claude mcp list

配置作用域

MCP 服务器的配置可以存在不同的位置，影响范围不同：

作用域存储位置影响范围参数
project项目根目录 .mcp.json仅当前项目，可提交到 git 共享--scope project
user~/.claude/.mcp.json所有项目--scope user

MCP 配置作用域：项目级 vs 用户级

项目级配置（推荐团队使用）

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem ./data --scope project

这会写入项目根目录的 .mcp.json 文件。提交到 git 后，团队里每个人用 Claude Code 时都能自动连接这些 MCP 服务器。

用户级配置（个人使用）

claude mcp add my-db npx -y @modelcontextprotocol/server-postgres postgres://localhost/mydb --scope user

这会写入 ~/.claude/.mcp.json，只对你自己生效，所有项目都能用。

有哪些实用的 MCP 服务器

MCP 生态正在快速发展，这里列几个常用的：

MCP 服务器用途安装命令
Filesystem受控的文件读写@modelcontextprotocol/server-filesystem
GitHub操作 GitHub 仓库、issue、PR@modelcontextprotocol/server-github
PostgreSQL查询 PostgreSQL 数据库@modelcontextprotocol/server-postgres
SQLite查询 SQLite 数据库@modelcontextprotocol/server-sqlite
Brave Search网络搜索@modelcontextprotocol/server-brave-search
Puppeteer浏览器自动化@modelcontextprotocol/server-puppeteer
Memory基于知识图谱的持久化记忆@modelcontextprotocol/server-memory
Slack读取和发送 Slack 消息@modelcontextprotocol/server-slack

更多 MCP 服务器可以在 GitHub 上搜索 awesome-mcp-servers，社区维护了不少精选列表。

实际使用场景

场景一：连接数据库做数据分析

添加 PostgreSQL MCP 服务器后，你可以直接跟 Claude Code 说：

帮我查一下 users 表里过去 7 天注册的用户数量，按天分组

Claude Code 会通过 MCP 服务器直接查询数据库，返回结果。不需要你自己写 SQL，也不需要复制粘贴查询结果。

场景二：让 Claude Code 管理 GitHub

添加 GitHub MCP 服务器后，Claude Code 能做的事情更多了：

  • 创建和关闭 issue
  • 查看 PR 的详细信息和评论
  • 搜索仓库中的代码
  • 读取其他仓库的文件

场景三：连接知识库

如果你的团队文档在 Notion 或 Confluence 里，通过对应的 MCP 服务器，Claude Code 可以直接查阅文档内容，而不是你手动复制粘贴给它。

实际使用技巧

技巧一：项目级配置提交到 git

把 .mcp.json 提交到仓库，团队成员 clone 下来就能用。但注意——不要把 API key 和密码写在 .mcp.json 里。敏感信息应该通过环境变量传入，或者放在用户级配置中。

技巧二：用环境变量管理密钥

claude mcp add-json my-api '{
  "command": "npx",
  "args": ["-y", "some-mcp-server"],
  "env": {
    "API_KEY": "${MY_API_KEY}"
  }
}'

把实际的密钥放在 .env 或 shell 配置里，.mcp.json 中只引用变量名。

技巧三：按需添加，不要贪多

每个 MCP 服务器都会占用 Claude Code 的上下文空间（因为需要描述可用的工具）。添加太多不常用的服务器会浪费 token。建议只添加你当前项目确实需要的。

技巧四：用 /mcp 排查问题

如果某个 MCP 服务器没有正常工作，在交互模式下输入 /mcp 查看状态。它会显示每个服务器是否成功连接、提供了哪些工具。连接失败的服务器会有明显的错误提示。

.mcp.json 长什么样

一个典型的项目级 .mcp.json 文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

结构很简单：mcpServers 对象下面，每个 key 是服务器名称，value 是启动配置——包括启动命令、参数和环境变量。

/mcp vs 手动配置

/mcp + CLI 命令手动编辑 .mcp.json
易用性命令行交互，不容易出错需要手写 JSON，可能格式出错
速度一行命令搞定需要找到文件、编辑、保存
灵活性覆盖常见场景可以写任意配置
适用场景日常添加/删除服务器批量配置、复杂场景

两种方式最终写入的是同一个配置文件，选哪个都行。日常使用推荐 CLI 命令，批量配置或者需要精细调整时直接编辑文件。

写在最后

/mcp 是 Claude Code 里一个扩展性极强的命令。它解决的问题很本质：让 Claude Code 不再局限于本地文件和终端命令，而是能连接到你的整个开发生态。

数据库、GitHub、文档系统、云服务——只要有对应的 MCP 服务器，Claude Code 就能直接操作。这把 AI 编程助手从”只能看代码”升级到了”能接触到你工作中的方方面面”。

下次遇到”要是 Claude Code 能直接查数据库就好了”这样的念头时，想想 MCP——很可能已经有现成的服务器可以用了。

相关推荐

AI-first 创业公司，为什么只需要一种编程语言？

技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。

cc-ping：一行命令 Ping 所有 Claude Code 配置

用多个 Claude Code API Key 或中继？cc-ping 帮你管理配置、一键切换，还能并行 Ping 所有节点比速度。

震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍

躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。

CCBot - 研发提效 24 倍

通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。

Claude Code /add-dir：被低估的 Monorepo 神器

Claude Code 默认只能看到当前目录。/add-dir 打破这个限制——分享我每天跨 5 个仓库使用的经验。

Claude Code 省 Token 小技巧：感叹号的妙用

一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。

我做了个机器人，让团队在飞书里用 Claude Code

CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。

Claude Code /btw 命令详解：不打扰主线的快问快答

详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。

Claude Code /compact：释放上下文，不丢进度

任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。

Claude Code /config：一文搞懂所有可调设置

用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。

Claude Code /context：你的上下文都被什么吃了？

对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。

Claude Code /diff：这次对话改了什么，一目了然

Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。

Claude Code /fast：同样的 Opus，两倍速——值不值？

/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。

Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7

用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。

Claude Code /hooks：让 AI 按你的规矩办事

想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。

Claude Code /init：10 秒自动生成 CLAUDE.md

别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。

Claude Code /memory 详解：让 AI 真正记住你的项目

详细介绍 Claude Code 的 /memory 命令和记忆系统——CLAUDE.md 手动指令、Auto Memory 自动记忆、模块化规则，让 Claude 跨会话记住项目规范和个人偏好。

Claude Code /model：Opus、Sonnet、Haiku 怎么选？

不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。

Claude Code /permissions：谁能干什么，你说了算

每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。

Claude Code /plan 详解：先想清楚再动手

详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。

Claude Code + Playwright MCP：AI 终于能"看见"页面了

一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。

Claude Code /resume 命令详解：别让对话白聊

详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。

Claude Code /review：让 AI 帮你做 Code Review

提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。

Claude Code Skills 详解：打造你的专属命令库

详细介绍 Claude Code 的 Skills 功能——创建自定义斜杠命令、复用提示词模板、共享团队最佳实践，让 AI 编程更高效更一致。

Claude Code /stats：看看 AI 到底帮你写了多少代码

好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。

Claude Code /status 命令详解：一眼看清会话全貌

详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。

Claude Code /tasks 命令详解：后台任务尽在掌控

详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。

Claude Code /usage 命令详解：你的额度还剩多少

详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。

Claude Code /vim：在 AI 编程助手里用 Vim 键位

习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。

Claude Code 使用指南：从安装到实战，一篇就够（2026）

用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。

Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚

一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。

Claude Code /agents 详解：自定义 AI 子代理，各司其职

详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。

Claude Code /doctor 详解：一键诊断你的开发环境

详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。

Claude Code /effort 详解：控制 AI 思考的深度

详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。

Claude Code /cost 详解：你的 AI 编程到底花了多少钱

详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。

Claude Code /export 详解：把 AI 对话带走

详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。

Claude Code /rewind 详解：AI 改错了？一键回退

详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。

Claude Code /plugin 详解：给你的 AI 编程助手装插件

详细介绍 Claude Code 的 /plugin 命令——管理插件的安装、启用、禁用和更新，通过插件扩展 Claude Code 的命令、技能、Agent 和 Hook，打造你专属的 AI 编程工具链。

Claude Code /theme 详解：给你的终端换个好看的皮肤

详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。

Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式

详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。

Claude Code /rename 详解：给你的会话取个有意义的名字

详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。

Claude Code settings.json 配置详解：5 层优先级、3 种文件路径，一篇搞懂

Claude Code 的 settings.json 到底放哪里？用户级、项目级、本地级有什么区别？什么是 managed-settings.json？一篇讲清 5 层配置的优先级规则、合并逻辑和实际使用场景。

Claude Code settings.json 详解（二）：permissions 权限系统全解析

深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。

Claude Code settings.json 详解（三）：hooks 钩子全解析

深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。

Claude Code settings.json 配置模板：env、模型、认证等实用字段速查

Claude Code settings.json 常用字段速查表：env 环境变量、模型切换、apiKeyHelper 动态认证、Git 署名、思考深度、语言与界面、自动更新等，附可直接复制的配置示例。

Claude Code Agent Loop：拆解 AI 编程助手的心脏

Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。

© 2026 vincentqiao.com . 保留所有权利。