Claude Code MCP：连接外部工具和数据源
什么是 MCP
Model Context Protocol (MCP) 是 Anthropic 推出的开放协议，定义了 AI 模型与外部工具之间的标准通信方式。通过 MCP，Claude Code 可以连接数据库、调用 API、操作第三方服务，将 AI 编程助手的能力从代码编辑扩展到整个开发工作流。
MCP 采用客户端-服务器架构：Claude Code 作为 MCP 客户端，通过标准协议与 MCP 服务器通信。每个 MCP 服务器暴露一组工具（tools），Claude 可以根据需要主动调用这些工具。
配置 MCP 服务器
在 .claude/settings.json 中添加 MCP 服务器配置：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
},
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "./data.db"]
}
}
}
配置完成后重启 Claude Code，即可在对话中使用这些外部工具。
常用 MCP 服务器
| 服务器 | 功能 | 包名 |
|---|---|---|
| GitHub | 管理 Issue、PR、仓库 | @modelcontextprotocol/server-github |
| Filesystem | 安全的文件系统访问 | @modelcontextprotocol/server-filesystem |
| SQLite | 查询 SQLite 数据库 | @modelcontextprotocol/server-sqlite |
| PostgreSQL | 查询 PostgreSQL 数据库 | @modelcontextprotocol/server-postgres |
| Slack | 发送消息、管理频道 | @modelcontextprotocol/server-slack |
| Memory | 跨会话持久化记忆 | @modelcontextprotocol/server-memory |
更多社区开发的 MCP 服务器可以在 MCP Servers 仓库 中找到。
编写简单的 MCP 服务器
你可以用 TypeScript 快速编写自定义 MCP 服务器：
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
const server = new McpServer({ name: "my-server", version: "1.0.0" });
server.tool(
"get_weather",
"获取指定城市的天气信息",
{ city: z.string().describe("城市名称") },
async ({ city }) => {
// 调用天气 API
const data = await fetch(`https://api.weather.com/${city}`);
return { content: [{ type: "text", text: JSON.stringify(await data.json()) }] };
}
);
const transport = new StdioServerTransport();
await server.connect(transport);
安全注意事项
- 最小权限原则：只授予 MCP 服务器必要的权限和访问范围
- 敏感信息保护：API 密钥通过
env字段传递，不要硬编码在配置中 - 网络隔离：对于访问内部服务的 MCP 服务器，确保网络访问控制得当
- 审查第三方服务器：使用社区 MCP 服务器前，务必审查其源代码
常见问题
MCP 服务器需要一直运行吗？
不需要。Claude Code 会在启动时自动拉起配置的 MCP 服务器进程，会话结束时自动关闭。你不需要手动管理服务器的生命周期。
一个项目可以同时使用多个 MCP 服务器吗？
可以。你可以在 mcpServers 中配置任意数量的服务器，Claude 会根据任务需要自动选择合适的工具调用。不同服务器的工具会合并到 Claude 的可用工具列表中。
自定义 MCP 服务器支持哪些编程语言？
MCP SDK 官方提供了 TypeScript 和 Python 版本。社区也有 Rust、Go、Java 等语言的实现。只要遵循 MCP 协议规范，任何语言都可以编写 MCP 服务器。
