教程

Claude Code MCP 服务器完整配置指南:10 个最实用的 MCP 集成

Claude Code MCP 服务器完整配置指南:MCP 协议三种能力(Tools/Resources/Prompts);全局和项目级配置方式;10 个最实用 MCP 集成详解(PostgreSQL 查询数据库/GitHub PR 管理/Slack 通知/Brave 实时搜索/Memory 跨会话知识/Jira 任务管理/Redis/AWS/自定义 HTTP API);v2.1.91 工具结果大小配置;v2.1.114 Hooks 直接调用 MCP 工具;以及安全最佳实践。

2026/5/35分钟 阅读ClaudeEagle

MCP(Model Context Protocol)是让 Claude Code 连接外部世界的标准协议。配置正确的 MCP 服务器,Claude Code 可以直接查询你的数据库、调用 GitHub API、搜索内部文档——不再需要手动复制粘贴数据。


什么是 MCP?

MCP 是 Anthropic 开源的标准协议,定义了 AI 模型如何与外部工具和数据源交互。可以理解为给 Claude Code 的"插头标准"——任何实现了 MCP 协议的服务器都可以直接接入。

MCP 的三种能力

  • Tools:Claude 可以调用的函数(查询数据库、发送消息等)
  • Resources:Claude 可以读取的数据(文件、API 响应等)
  • Prompts:可复用的提示词模板

配置方式

全局配置(所有项目可用)

json
// ~/.claude/settings.json
{
  "mcpServers": {
    "server-name": {
      "command": "命令",
      "args": ["参数"],
      "env": {
        "ENV_VAR": "值"
      }
    }
  }
}

项目级配置(仅当前项目)

json
// .claude/settings.json
{
  "mcpServers": {
    "project-specific-server": {
      "command": "npx",
      "args": ["-y", "my-custom-mcp-server"]
    }
  }
}

10 个最实用的 MCP 集成

1. PostgreSQL/MySQL 数据库

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

能做什么

  • 直接查询数据库 Schema,不需要手动粘贴表结构
  • 运行 SELECT 查询验证数据
  • 分析查询性能
> 查看 users 表的完整结构,以及最近 7 天的新注册量 > 分析 orders 表里响应时间超过 2 秒的查询

2. GitHub

json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

能做什么

  • 查看 PR 状态、CI 结果
  • 创建 Issue 和评论
  • 搜索代码库
> 查看所有标注了 "bug" 且超过 7 天没有更新的 Issue > 检查 PR #234 的 CI 状态,如果失败了找出失败原因

3. Slack

json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}",
        "SLACK_TEAM_ID": "${SLACK_TEAM_ID}"
      }
    }
  }
}

能做什么

  • 发送通知到频道
  • 读取特定频道的消息

4. 文件系统扩展访问

json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/documents",
        "/Users/you/projects"
      ]
    }
  }
}

用于 Monorepo 或需要访问项目目录之外的文件。

5. Brave Search(实时网页搜索)

json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "${BRAVE_API_KEY}"
      }
    }
  }
}

能做什么

  • 搜索最新的技术文档
  • 查找某个库的最新版本
  • 实时研究
> 搜索 React 19 的 breaking changes,看看我们的代码库需要哪些迁移

6. 跨会话持久知识(Memory)

json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

能做什么

  • 保存重要信息跨会话使用
  • 存储团队约定、决策记录
  • 积累项目特定知识

7. Jira

json
{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-jira"],
      "env": {
        "JIRA_URL": "${JIRA_URL}",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

能做什么

  • 查看当前 Sprint 的任务
  • 更新 Issue 状态
  • 根据 Jira ticket 直接实现功能
> 查看 PROJ-1234,根据描述和验收标准实现这个功能,完成后更新状态为 In Review

8. Redis

json
{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-redis"],
      "env": {
        "REDIS_URL": "${REDIS_URL}"
      }
    }
  }
}

能做什么

  • 检查缓存命中率
  • 查看特定 key 的值
  • 分析内存使用

9. AWS(S3、DynamoDB 等)

json
{
  "mcpServers": {
    "aws": {
      "command": "npx",
      "args": ["-y", "@aws/mcp-server"],
      "env": {
        "AWS_ACCESS_KEY_ID": "${AWS_ACCESS_KEY_ID}",
        "AWS_SECRET_ACCESS_KEY": "${AWS_SECRET_ACCESS_KEY}",
        "AWS_DEFAULT_REGION": "us-east-1"
      }
    }
  }
}

10. 自定义 HTTP API

json
{
  "mcpServers": {
    "internal-api": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "API_BASE_URL": "https://api.internal.example.com",
        "API_KEY": "${INTERNAL_API_KEY}"
      }
    }
  }
}

MCP 工具结果大小配置(v2.1.91)

对于返回大体积结果的工具(数据库 Schema、文件树等),可以调高上限:

json
// MCP 服务器的 tools/list 响应里
{
  "name": "get_full_schema",
  "description": "获取完整数据库 Schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 500000  // 最高 50 万字符
  }
}

Hooks 直接调用 MCP 工具(v2.1.114)

json
// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write(**/*.ts)",
      "hooks": [{
        "type": "mcp_tool",
        "server": "slack",
        "tool": "post_message",
        "input": {
          "channel": "#dev-updates",
          "text": "TypeScript 文件已更新"
        }
      }]
    }]
  }
}

直接调用 MCP 工具而不是启动新进程,速度更快,复用已连接的服务器。


安全最佳实践

  1. 用环境变量存储密钥,不要硬编码在 settings.json 里
  2. 最小权限原则:数据库 MCP 只给 SELECT 权限
  3. Auto Mode + MCP:Auto Mode 会评估 MCP 工具调用的安全性
  4. 审计日志:用 Hooks 记录所有 MCP 工具调用
bash
# 查看已配置的 MCP 服务器
> /mcp

# 在 Claude Code 里查看可用工具
> 列出所有可用的 MCP 工具

来源:Claude Code MCP 官方文档 | MCP 官方协议 | 整理:ClaudeEagle

相关文章推荐

教程Hermes Agent MCP 集成完全指南:GitHub、数据库、内部 API 连接实战Hermes Agent MCP 集成完整教程:常用 MCP Server 安装配置(GitHub/PostgreSQL/Slack),v0.8.0 新增 OAuth 2.1 PKCE 安全认证和 OSV 漏洞扫描,GitHub 完整操作和数据库查询实战示例,以及自己开发 MCP Server 的快速入门。2026/4/16教程Claude Code MCP 配置完全指南:5 分钟连接 GitHub、Notion、数据库等 100+ 外部服务Claude Code MCP 完全配置指南:5 分钟连接 GitHub、Notion、Stripe 等外部服务。含 3 种添加方法、常用服务命令速查、传输协议选择和连接失败排查。2026/4/9教程Claude Code MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code MCP 集成指南:连接 Jira、GitHub、Slack 等外部工具Claude Code MCP 集成完整指南:MCP 协议原理、快速配置 GitHub/Postgres/Slack 等现成 Server、TypeScript 开发自定义 MCP Server 示例、三个实战场景(Bug 处理/站会准备/数据优化)、安全配置建议。2026/3/12教程Claude Code MCP 完全指南:三种安装方式、三级作用域、OAuth 认证与企业管控策略Claude Code MCP 完全指南:三种安装方式(远程 HTTP 推荐/SSE 废弃/本地 Stdio)、三级作用域(local/project/user)及优先级规则、Sentry+GitHub+PostgreSQL 实战示例、OAuth 2.0 认证(/mcp 命令/固定端口/预配置凭证)、/mcp__server__prompt 命令格式、资源引用语法,以及企业管控(managed-mcp.json 白名单黑名单策略)。2026/3/5教程Claude Code Slack 集成完全指南:让团队在工作频道里直接触发 AI 编程任务Claude Code Slack 集成完整指南:5 大核心能力(代码问答/任务执行/代码审查/CI 通知/团队协作)、按频道设置权限(read/write/execute/pr 四级)、人工审批工作流配置、GitHub Actions CI 失败自动触发 Claude 分析和修复、4 个团队场景(技术支持/新人上手/PM 提需求/凌晨紧急修复),以及 Slack 集成安全最佳实践。2026/4/26