第三章. MCP 服务器接入

本章学习路径

3.1. MCP 是什么

上一章我们学会了配置 Claude Code 的行为。但有个根本性的限制没有突破：Claude 只能访问本地资源。

“我想让 Claude 帮我查一下 GitHub 上的 Issue 列表。”

默认情况下，Claude 做不到。它没有 GitHub 的访问权限，也不知道如何调用 GitHub API。

MCP 就是为了解决这个问题而生的。

3.1.1. 协议原理简述

核心思想：

把 “AI 如何调用外部工具” 这件事标准化。就像 USB 协议让各种设备都能插到电脑上一样，MCP 让各种工具都能 “插到” Claude 上。

架构示意：

1
2
3
4
5
6
7
8
9
10
11

┌─────────────┐     MCP 协议     ┌─────────────┐
│ Claude Code │ ◄──────────────► │ MCP Server  │
└─────────────┘                  └─────────────┘
                                       │
                                       ▼
                                 ┌─────────────┐
                                 │ 外部服务     │
                                 │ (GitHub,    │
                                 │  Database,  │
                                 │  Notion...) │
                                 └─────────────┘

Claude Code 通过 MCP 协议与 MCP Server 通信，MCP Server 再去调用实际的外部服务。

3.1.2. 能解决什么问题

接入 MCP 后，你可以让 Claude 做这些事：

常见的 MCP 服务器：

3.1.3. 本节小结

MCP 的核心价值是 扩展 Claude 的能力边界：

3.2. 三种接入方式

MCP 服务器有三种连接方式，适用于不同的场景。

3.2.1. HTTP 远程服务器（推荐）

这是最常用的方式，适合连接云端的 MCP 服务。

语法：

1

claude mcp add --transport http <名称> <URL>

示例：连接 Notion

1

claude mcp add --transport http notion https://mcp.notion.com/mcp

带认证的示例：

1
2

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

适用场景：

• 官方提供的云端 MCP 服务（如 Notion、Sentry）
• 需要 OAuth 认证的服务

3.2.2. SSE 服务器

语法：

1

claude mcp add --transport sse <名称> <URL>

示例：连接 Asana

1

claude mcp add --transport sse asana https://mcp.asana.com/sse

适用场景：

• 需要实时数据推送的服务
• 某些特定的第三方 MCP 服务

3.2.3. stdio 本地服务器

这种方式是在本地运行一个 MCP 服务器进程，通过标准输入输出（stdin/stdout）与 Claude Code 通信。

语法：

1

claude mcp add --transport stdio <名称> -- <命令> [参数...]

示例：连接本地数据库

1
2

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

示例：连接 Airtable

1
2

claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

适用场景：

• 本地数据库连接
• 自定义的 MCP 服务器
• 需要访问本地资源的服务

3.2.4. 本节小结

三种接入方式的选择：

3.3. MCP 作用域管理

和 settings.json 一样，MCP 服务器配置也有作用域的概念。

3.3.1. local / project / user 三种作用域

指定作用域：

1
2
3
4
5
6
7
8

# 默认是 local
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 指定为 project（团队共享）
claude mcp add --transport http github --scope project https://api.githubcopilot.com/mcp/

# 指定为 user（跨项目）
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

3.3.2. .mcp.json 项目级配置

当你使用 --scope project 添加 MCP 服务器时，配置会写入项目根目录的 .mcp.json 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "postgresql://..."],
      "env": {}
    }
  }
}

这个文件可以提交到 Git，团队成员克隆项目后就能使用相同的 MCP 配置。

3.3.3. 环境变量展开

.mcp.json 支持环境变量展开，这样你就不用把敏感信息硬编码在配置文件里：

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

语法说明：

• ${VAR} —— 展开为环境变量 VAR 的值
• ${VAR:-default} —— 如果 VAR 未设置，使用 default

3.3.4. 本节小结

MCP 作用域的选择：

3.4. 实战：接入 GitHub MCP

理论讲完了，现在来实战。我们以 GitHub MCP 为例，完成一个完整的接入流程。

3.4.1. 添加服务器

步骤 1：执行添加命令

1

claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

成功现象：终端显示 MCP server 'github' added successfully。

步骤 2：验证添加结果

1

claude mcp list

你应该能看到 github 出现在列表中。

3.4.2. OAuth 认证

GitHub MCP 需要 OAuth 认证才能访问你的仓库。

步骤 1：进入 Claude Code

1

claude

步骤 2：触发认证流程

1

› /mcp

在弹出的菜单中，选择 github，然后选择 Authenticate。

步骤 3：完成浏览器授权

浏览器会自动打开 GitHub 授权页面。点击 “Authorize” 授权 Claude Code 访问你的 GitHub 账户。

成功现象：浏览器显示 “Authorization successful”，终端显示认证完成。

3.4.3. 使用示例

认证完成后，你就可以让 Claude 操作 GitHub 了：

查看 PR 列表：

1

› 帮我看看这个仓库有哪些待审核的 PR

创建 Issue：

1

› 在 GitHub 上创建一个 Issue，标题是"修复登录页面的样式问题"，内容描述一下 CSS 布局错位的情况

审查代码：

1

› 帮我审查一下 PR #789 的代码变更，重点关注安全问题

查看仓库信息：

1

› 这个仓库最近一周有哪些提交？

3.4.4. 本节小结

GitHub MCP 接入流程：

3.5. MCP 服务器速查手册

上一节我们完成了 GitHub MCP 的接入实战。但 MCP 生态远不止 GitHub 一个，还有查文档的、搜代码的、操作数据库的、甚至防止 AI “早退” 的……

“这么多 MCP，我怎么知道哪个适合我？”

别急，本节就是一份 速查手册。我们把常用的 MCP 按 “配置难度” 分成四类，每个都给出 用途说明 + 完整配置，你只需要复制粘贴就能用。

3.5.1. 配置文件在哪

claude mcp add 命令有时候会抽风——添加失败、格式错乱、莫名报错。与其和命令行较劲，不如直接编辑配置文件，简单粗暴。

打开这个文件，你会看到类似这样的结构：

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "服务名称": {``
      "command": "启动命令",
      "args": ["参数1", "参数2"],
      "env": {
        "环境变量名": "值"
      }
    }
  }
}

3.5.2. 开箱即用型

这类 MCP 不需要任何前置安装，复制配置、重启 Claude Code 就能直接用。

Context7 —— 第三方库文档查询

写代码时想查某个库的用法？Context7 能帮你拉取 npm、PyPI 等平台上的最新文档，直接喂给 Claude。

1
2
3
4

"Context7": {
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp@latest"]
}

📎 GitHub 仓库

Sequential Thinking —— 分步思考

让 Claude 在处理复杂问题时，强制分步骤推理，而不是一股脑给你一个答案。适合逻辑链较长的任务。

1
2
3
4

"Sequential Thinking": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}

📎 官方 MCP Servers

filesystem —— 文件系统访问

让 Claude 能读写指定目录下的文件。注意：只有你配置的目录才会被授权访问。

1
2
3
4
5
6
7
8
9

"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "D:\\Projects",
    "C:\\Users\\你的用户名\\Desktop"
  ]
}

📎 官方 MCP Servers

memory —— 持久化记忆

让 Claude 拥有 “长期记忆”。它会把你们的对话要点存下来，下次聊天时还能记得。

1
2
3
4

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

📎 官方 MCP Servers

deepwiki —— 开源项目文档查询

想了解某个 GitHub 开源项目的架构？deepwiki 能帮你快速获取项目文档和代码结构分析。

1
2
3
4

"deepwiki": {
  "type": "http",
  "url": "https://mcp.deepwiki.com/mcp"
}

📎 官网

time-mcp —— 获取当前时间

Claude 默认不知道 “现在几点”。这个 MCP 让它能获取准确的系统时间，适合需要时间感知的任务。

1
2
3
4

"time-mcp": {
  "command": "npx",
  "args": ["-y", "time-mcp"]
}

playwright —— 浏览器自动化

让 Claude 能控制浏览器：打开网页、点击按钮、填写表单、截图……自动化测试或爬虫场景必备。

1
2
3
4

"playwright": {
  "command": "npx",
  "args": ["-y", "@playwright/mcp@latest"]
}

📎 GitHub 仓库

docker —— 容器管理

让 Claude 能查看、启动、停止你的 Docker 容器。适合需要频繁操作容器的开发场景。

1
2
3
4

"docker": {
  "command": "npx",
  "args": ["-y", "mcp-server-docker"]
}

📎 GitHub 仓库

3.5.3. 需要 API Key 型

这类 MCP 需要去官网注册账号、获取密钥，然后填到配置里。

github —— GitHub 操作

让 Claude 能查 Issue、提 PR、搜代码、看提交记录……几乎所有 GitHub 操作都能做。

1
2
3
4
5
6
7

"github": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_你的Token"
  }
}

Token 获取方式：

1. 打开 GitHub → 右上角头像 → Settings
2. 左侧菜单最底部 → Developer settings
3. Personal access tokens → Tokens (classic) → Generate new token
4. 勾选 repo、read:org 等你需要的权限

📎 官方 MCP Servers

Exa AI —— AI 搜索引擎

比传统搜索更智能的 AI 搜索。它能理解你的问题语义，返回更精准的结果。

1
2
3
4

"Exa AI": {
  "type": "http",
  "url": "https://mcp.exa.ai/mcp"
}

📎 官网

magic —— AI 组件生成

21st.dev 出品的 AI 组件生成器。描述你想要的 UI 组件，它直接给你生成代码。

1
2
3
4
5
6
7

"magic": {
  "command": "npx",
  "args": ["-y", "@21st-dev/magic@latest"],
  "env": {
    "API_KEY": "你的21st_API_KEY"
  }
}

Key 获取方式：去 21st.dev 注册账号，在控制台获取 API Key。

📎 21st.dev 官网

supabase —— Supabase 数据库操作

让 Claude 能查询和操作你的 苏帕贝斯一个开源的 Firebase 替代品，提供数据库、认证、存储等后端服务 数据库。

1
2
3
4
5
6
7
8
9
10
11
12

"supabase": {
  "command": "npx",
  "args": [
    "-y",
    "@supabase/mcp-server-supabase@latest",
    "--read-only",
    "--project-ref=你的项目ID"
  ],
  "env": {
    "SUPABASE_ACCESS_TOKEN": "sbp_你的Token"
  }
}

配置说明：

• --read-only：只读模式，防止误操作删库
• --project-ref：在 Supabase 控制台的项目设置里找

📎 GitHub 仓库

3.5.4. 需要本地服务型

这类 MCP 需要你本地先跑起对应的服务（数据库、搜索引擎等）。

mysql —— MySQL 数据库操作

让 Claude 能直接查询你的 MySQL 数据库。写 SQL、分析数据、排查问题都很方便。

1
2
3
4
5
6
7
8

"mysql": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-server-mysql",
    "mysql://用户名:密码@localhost:3306/数据库名"
  ]
}

📎 GitHub 仓库

redis-mcp —— Redis 操作

让 Claude 能读写你的 Redis 缓存。查 Key、设值、排查缓存问题都能搞定。

1
2
3
4
5
6
7
8
9
10

"redis-mcp": {
  "command": "npx",
  "args": [
    "@pickstar-2002/redis-mcp@latest",
    "--host", "localhost",
    "--port", "6379",
    "--password", "",
    "--db", "0"
  ]
}

everything-search —— Windows 全盘搜索

Windows 用户福音！让 Claude 能用 一款 Windows 上的极速文件搜索工具 搜索你电脑上的任何文件。

1
2
3
4
5
6
7

"everything-search": {
  "command": "uvx",
  "args": ["mcp-server-everything-search"],
  "env": {
    "EVERYTHING_SDK_PATH": "E:\\everythingsdk\\dll\\Everything64.dll"
  }
}

前置安装：

1. 下载并安装 Everything
2. 下载 Everything SDK
3. 解压 SDK，把 Everything64.dll 的路径填到配置里

📎 GitHub 仓库

excel —— Excel 文件操作

让 Claude 能读写 Excel 文件。数据分析、报表生成、批量处理都能用。

1
2
3
4
5
6
7

"excel": {
  "command": "npx",
  "args": ["-y", "@zhiweixu/excel-mcp-server"],
  "env": {
    "LOG_PATH": "E:\\Logs\\excel.txt"
  }
}

📎 GitHub 仓库

3.5.5. 需要额外安装型

这类 MCP 不能直接 npx 跑，需要先手动安装到系统里。

deepwebresearch —— 深度网络研究

让 Claude 能进行深度的网络调研：多轮搜索、内容提取、相关性分析……比普通搜索更深入。

安装步骤：

1
2
3

npm install -g mcp-deepwebresearch

npx playwright install chromium

配置：

1
2
3
4

"deepwebresearch": {
  "command": "mcp-deepwebresearch",
  "args": []
}

📎 ModelScope 页面

MCP Feedback Enhanced —— 交互反馈收集

这是一个 “人机协作” 神器。当 Claude 完成一个阶段的工作后，会弹出一个界面让你确认或补充反馈，而不是自顾自地继续干。适合需要精细控制 AI 行为的场景。

安装步骤：

1

pip install uv

配置（Web 界面模式）：

1
2
3
4
5
6

"mcp-feedback-enhanced": {
  "command": "uvx",
  "args": ["mcp-feedback-enhanced@latest"],
  "timeout": 600,
  "autoApprove": ["interactive_feedback"]
}

配置（桌面应用模式）：

1
2
3
4
5
6
7
8
9

"mcp-feedback-enhanced": {
  "command": "uvx",
  "args": ["mcp-feedback-enhanced@latest"],
  "timeout": 600,
  "env": {
    "MCP_DESKTOP_MODE": "true"
  },
  "autoApprove": ["interactive_feedback"]
}

📎 GitHub 仓库

寸止 —— 防止 AI 提前结束对话

“还有什么需要帮助的吗？” —— 是不是经常被 AI 这句话噎住？明明还有很多要聊，它却想草草收场。

寸止就是专治这个毛病的。当 AI 想结束对话时，它会弹出一个窗口让你选择：继续深入、换个方向、还是真的结束。

安装步骤：

1

brew tap imhuso/cunzhi && brew install cunzhi

配置：

1
2
3
4

"寸止": {
  "command": "cunzhi",
  "args": []
}

额外步骤：安装后在终端运行 等一下 命令，会打开设置界面。在 “参考提示词” 标签页复制生成的提示词，添加到 Claude Code 的系统提示中。

📎 GitHub 仓库

3.5.6. 本节小结

本节我们梳理了 20+ 个常用 MCP 的配置方法。核心要点：