实战

Claude Code MCP 集成实战:连接外部服务、数据库与 API 的完整教程

Claude Code MCP 集成实战:配置文件格式(.mcp.json)、常用 MCP 服务器(GitHub/PostgreSQL/Slack/Brave Search)、三大实战场景(数据库分析/GitHub 自动化/邮件处理),以及 MCP 服务器类型、管理命令和安全注意事项。

2026/3/24分钟 阅读ClaudeEagle

模型上下文协议(MCP,Model Context Protocol)是 Anthropic 开源的 AI 工具连接标准。通过 MCP,Claude Code 可以直接访问数据库、调用 API、操作外部服务——而不需要你手动复制粘贴数据。

MCP 是什么?

MCP 是一个开放标准,让 AI 助手能够安全地访问和操作外部数据源及工具。就像 USB 插口一样——任何符合 MCP 规范的服务,都可以被任何支持 MCP 的 AI 工具直接使用。

MCP 服务器:提供数据和操作的服务(你的数据库、GitHub、Google Drive 等)

MCP 客户端:使用这些服务的 AI ���具(Claude Code、claude.ai 等)

配置 MCP 服务器

在 Claude Code 中添加 MCP 服务器

bash
# 交互式添加
claude mcp add

# 或直接指定
claude mcp add --name github --command "npx @modelcontextprotocol/server-github"

配置文件方式(.mcp.json

在项目根目录创建 .mcp.json

json
{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "pipedream": {
      "type": "http",
      "url": "https://mcp.pipedream.net/v2"
    }
  }
}

常用 MCP 服务器

文件系统

json
{
  "filesystem": {
    "type": "stdio",
    "command": "npx",
    "args": ["@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
  }
}

让 Claude Code 访问指定目录的文件,适合隔离访问特定项目目录。

GitHub

json
{
  "github": {
    "type": "stdio",
    "command": "npx",
    "args": ["@modelcontextprotocol/server-github"],
    "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
  }
}

让 Claude Code 直接操作 GitHub:读取 Issues、创建 PR、查看代码。

PostgreSQL/MySQL

json
{
  "postgres": {
    "type": "stdio",
    "command": "npx",
    "args": ["@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]
  }
}

让 Claude Code 查询数据库、分析数据结构。

Brave Search(网络搜索)

json
{
  "brave-search": {
    "type": "stdio",
    "command": "npx",
    "args": ["@modelcontextprotocol/server-brave-search"],
    "env": { "BRAVE_API_KEY": "BSA..." }
  }
}

Slack

json
{
  "slack": {
    "type": "stdio",
    "command": "npx",
    "args": ["@modelcontextprotocol/server-slack"],
    "env": { "SLACK_BOT_TOKEN": "xoxb-..." }
  }
}

实战场景

场景 1:结合数据库分析业务问题

bash
# 配置好 postgres MCP 后
claude
> 查询 orders 表,分析过去 30 天的销售趋势,找出下单量最高的时间段和最受欢迎的商品类别

Claude Code 直接查询数据库,生成分析报告。

场景 2:GitHub 自动化

bash
> 读取 #234 Issue 的内容,在 feature/fix-234 分支上实现需求,然后创建 PR 并关联这个 Issue

Claude Code 通过 GitHub MCP 完成从读 Issue 到创建 PR 的完整流程。

场景 3:邮件处理(结合 Pipedream)

bash
> 检查我的邮件,找出过去一周未回复的客户邮件,为每封写一个草稿回复

Pipedream MCP 连接 Gmail,Claude Code 读取邮件并生成草稿。

管理 MCP 服务器

bash
claude mcp list          # 查看已配置的服务器
claude mcp add          # 添加服务器
claude mcp remove name  # 删除服务器
claude mcp get name     # 查看单个配置

MCP 服务器类型

类型说明适用场景
stdio本地进程,通过标准 I/O 通信本地工具、CLI
http远程 HTTP 服务云服务、SaaS API
sseServer-Sent Events(流式)实时数据

安全注意事项

  • MCP 服务器以当前用户权限运行,注意访问控制
  • 数据库连接字符串包含密码,不要提交到 git
  • 使用 .mcp.json.local(加入 .gitignore)存储含密钥的配置
  • HTTP MCP 服务器的 URL 可能日志中可见,注意不要包含敏感信息

发现更多 MCP 服务器


原文整理自:Claude Code MCP 文档 | 来源:Anthropic 官方文档

相关文章推荐

实战AI 辅助 Code Review:用 Claude Code 让 PR 审查效率提升 3 倍用 Claude Code 做 AI 辅助代码审查完整指南:Pre-commit Hook 自动检查、PR Review 流程接入、自定义审查规则、与 GitHub Actions 集成、常见审查场景的 Prompt 模板,及人机协作最佳实践。2026/3/14实战Claude Code 与 MCP(Model Context Protocol)集成实战:连接 GitHub、Slack、数据库全流程Claude Code 与 MCP 集成实战完整指南:MCP 三类能力(Tools/Resources/Prompts)、三种配置方式(/mcp 交互命令/.mcp.json 项目级/~/.claude.json 用户级)、GitHub 完整配置(列出 Issues/查看 PR 评论)、Slack 配置(提炼技术决策)、PostgreSQL 配置(分析数据异常)、官方插件市场 8 个预配置 MCP 插件(GitHub/Slack/Atlassian/Linear/Notion/Sentry/Figma/Vercel)、MCP Prompts 作为 /mcp__server__prompt 格式斜杠命令、企业安全白名单(allowManagedMcpServersOnly/enabledMcpjsonServers)和 MCP 调试方法(/mcp/reconnect/--mcp-debug)。2026/3/8实战用 Claude Code 处理邮件:MCP + Pipedream 打造个人邮件 AI 代理Harper Reed 用 Claude Code + Pipedream MCP 处理积压邮件:代理读取邮件起草回复、检查日历,人工审核后发送。含血泪教训、CLAUDE.md 规则、Skill 文件配置和 Pipedream MCP 工具栈完整实战教程。2026/3/1实战用 Claude Code + MCP 自动处理邮件:实战经验与避坑指南Harper Reed 用 Claude Code + Pipedream MCP 打造邮件自动处理工作流:Agent 检查收件箱、匹配个人写作风格起草回复、仅保存草稿由人工审核。包含完整目录结构、CLAUDE.md 配置、MCP 服务器设置,以及「让 Agent 直接发邮件」的惨痛教训。2026/2/28实战Claude Code 命令行工具开发实战:用 AI 快速构建专业 CLI 工具Claude Code 辅助命令行工具(CLI)开发的完整实战指南:Python Click/Typer、Go Cobra、Rust Clap 技术栈选型、用 Claude Code 生成完整 CLI 项目结构(参数解析/子命令/全局选项)、交互式提示和彩色输出、配置文件管理、Shell 自动补全生成、跨平台打包(PyInstaller/goreleaser),以及发布到 PyPI/npm/Homebrew 的完整流程。2026/3/26实战Claude Code Vue 3 实战完全指南:Composition API 开发到企业级前端工程化Claude Code 辅助 Vue 3 开发的完整实战指南:Composition API 组件生成(setup/ref/computed)、Pinia 状态管理代码生成、Vue Router 4 路由配置、TypeScript 类型定义生成(Props/Emits)、Composables 抽象、Vitest 单元测试生成、性能优化(虚拟滚动/v-memo),以及 Options API 迁移和响应式丢失问题排查的 Prompt 模板。2026/3/26