今天继续填坑Claude Code进阶，从安装到入门，昨天也一并把命令系统分享了，作为Claude原厂的配件，怎么能少了MCP，所以今天就教大家如何在 Claude Code 里面使用 MCP，以及MCP的多种接入方式！
回顾Claude Code安装入门教程：
Claude Code 官方已支持Windows系统！手把手教你免费安装使用Claude Code
Claude Code入门篇：Claude Code 新手入门介绍与使用教程
Claude Code进阶篇：Claude Code命令系统，全流程工程实践探索
Claude Code完成最后一块拼图，Claude Code支持远程 MCP 服务器
今天苏米就把这一份Claude Code + MCP 实战的指南，帮你从零开始掌握Claude Code + MCP的所有核心技能。
第一章：MCP
1.1 什么是MCP？
MCP的全称是Model Context Protocol，由Anthropic开发，被描述为"AI的USB-C"。但这个比喻还不够准确。
更准确的理解：MCP是AI的"中枢神经系统"
想象你的AI助手原本只是一个"大脑"，只能思考和说话。MCP就像是给这个大脑接上了：
1.2 MCP的核心价值
传统的AI工作流程：开发者 → 复制代码 → 粘贴到AI → 获得建议 → 手动执行
MCP驱动的工作流程：开发者 → 直接对话 → AI自动分析、执行、反馈 → 完成任务
MCP让AI能够读取、写入和编辑本地文件，从API拉取实时数据并运行计算，触发操作如发送Slack警报或更新GitHub issue。
第二章：Claude Code安装与配置
这里就不重复了，可以看之前的安装教程：手把手教你免费安装使用Claude Code
第三章：MCP安装的四种方式详解
3.1 方式一：命令行安装（推荐新手）
Claude Code的默认方法是通过CLI向导（claude mcp add）。
-s 参数：表示执行配置文件的存储位置
user：全局粒度
local：项目粒度
-e 参数：设置环境变量
必备MCP服务器推荐：
1. GitHub集成（开发者必备）
claude mcp add github-server -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxx -- npx "@modelcontextprotocol/server-github"
权限设置重点：
-
repo: 完整仓库访问
-
read:user: 读取用户信息
-
read:org: 读取组织信息
2. Playwright自动化（效率神器）
claude mcp add playwright -s user -- npx @playwright/mcp@latest
3. 文件系统操作
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Desktop ~/Downloads
4. PostgreSQL数据库连接
claude mcp add postgresql -s user -e POSTGRES_CONNECTION_STRING="postgresql://user:password@localhost:5432/dbname" -- npx -y @modelcontextprotocol/server-postgres
3.2 方式二：SSE远程服务（推荐企业用户）
目前官方支持 SSE 的方式，也就是 HTTP stream 的方式，SSE 表示服务器在远程，别人已经帮你配置好，你通过客户端直接连接就行。
前面之前配置的有 command 的参数，都是会在本地配置的电脑启动服务的
看了下，都不是大家很经常用的，有些比如 Cloudflare、Sentry、Atlassian 知道些，其他真是不怎么用。
对于企业级部署，SSE方式提供了更好的性能和稳定性。
# 高德地图API集成
claude mcp add --transport sse mcp_server_amap https://mcp.amap.com/sse?key=YOUR_API_KEY
> 帮我看下深圳的天气怎么样？
3.3 方式三：JSON配置文件（推荐高级用户）
许多开发者发现CLI方式配置MCP工具令人沮丧，JSON配置提供了更好的控制。
创建 ~/.claude/.mcp.json：这个是全局生效的，所有项目都可以看到
{
"mcpServers": {
"zen": {
"command": "sh",
"args": [
"-c",
"exec $(which uvx || echo uvx) --from git+https://github.com/BeehiveInnovations/zen-mcp-server.git zen-mcp-server"
],
"env": {
"PATH": "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:~/.local/bin",
"GEMINI_API_KEY": "your_gemini_api_key",
"OPENAI_API_KEY": "your_openai_api_key"
}
},
"docker": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-docker"],
"env": {
"DOCKER_HOST": "unix:///var/run/docker.sock"
}
},
"obsidian": {
"command": "node",
"args": ["/path/to/obsidian-mcp-server/dist/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
}
}
}
}
还可以在项目录下新建，这个就是项目级配置 .mcp.json：
{
"mcpServers": {
"project-specific": {
"command": "python",
"args": ["-m", "project_mcp_server"],
"env": {
"PROJECT_ROOT": ".",
"DATABASE_URL": "sqlite:///./project.db"
}
}
}
}
当你再从 claude 进入的时候，就会提示你是否安装项目级别的 MCP
3.4 方式四：从Claude Desktop导入
# 一键导入已有配置
claude mcp add-from-claude-desktop
执行的时候，就会让你选择哪些从 Claude Desktop 导入
只用空格来选择哪些需要导入的。
第四章：MCP服务器推荐
基于最新的社区反馈和实际使用经验，开发者需要能够简化工作流程、提高生产力和自动化任务的工具。
4.1 开发类MCP服务器
1. GitHub MCP Server
# 功能：Issue管理、PR审查、仓库分析
claude mcp add github -e GITHUB_TOKEN=ghp_xxxxx -- npx @modelcontextprotocol/server-github
# 实际使用案例
# "分析我的仓库中所有关于认证的issue"
# "创建一个新的PR来修复这个bug"
# "查看最近一周的commit统计"
2. Docker MCP Server
# 功能：容器管理、镜像构建、日志查看
claude mcp add docker -- npx @modelcontextprotocol/server-docker
# 使用案例
# "启动开发环境的所有容器"
# "构建并推送Docker镜像"
# "查看nginx容器的实时日志"
3. Kubernetes MCP Server
# 功能：集群管理、Pod监控、服务部署
claude mcp add kubernetes -e KUBECONFIG=/path/to/kubeconfig -- npx @modelcontextprotocol/server-kubernetes
4.2 数据库类MCP服务器
1. PostgreSQL MCP Server
claude mcp add postgresql -e POSTGRES_CONNECTION_STRING="postgresql://user:pass@localhost:5432/db" -- npx @modelcontextprotocol/server-postgres
2. MongoDB MCP Server
claude mcp add mongodb -e MONGODB_URI="mongodb://localhost:27017/mydb" -- npx @modelcontextprotocol/server-mongodb
3. Redis MCP Server
claude mcp add redis -e REDIS_URL="redis://localhost:6379" -- npx @modelcontextprotocol/server-redis
4.3 自动化类MCP服务器
1. Playwright MCP Server（网页自动化）
claude mcp add playwright -- npx @playwright/mcp@latest
# 强大的自动化能力
# "打开小红书，搜索'AI开发'，总结前10个结果"
# "自动填写表单并提交"
# "监控网站变化并发送通知"
2. Puppeteer MCP Server
claude mcp add puppeteer -- npx @modelcontextprotocol/server-puppeteer
4.4 云服务类MCP服务器
1. AWS MCP Server
claude mcp add aws -e AWS_ACCESS_KEY_ID=xxx -e AWS_SECRET_ACCESS_KEY=xxx -- npx @modelcontextprotocol/server-aws
2. DigitalOcean MCP Server DigitalOcean MCP服务器让在Claude Code中部署应用变得更容易
claude mcp add digitalocean -e DO_API_TOKEN=xxx -- npx @modelcontextprotocol/server-digitalocean
第五章：高级配置与优化
5.1 性能优化配置
内存优化配置
{
"mcpServers": {
"heavy-server": {
"command": "node",
"args": ["--max-old-space-size=4096", "/path/to/server.js"],
"env": {
"NODE_OPTIONS": "--max-old-space-size=4096"
}
}
}
}
并发控制配置
{
"mcpServers": {
"concurrent-server": {
"command": "python",
"args": ["-m", "server", "--max-workers=4"],
"env": {
"MAX_CONCURRENT_REQUESTS": "10"
}
}
}
}
5.2 安全配置最佳实践
1. 环境变量管理
# 创建专用的环境变量文件
echo "GITHUB_TOKEN=ghp_xxxxx" > ~/.claude/.env
echo "DATABASE_URL=postgresql://..." >> ~/.claude/.env
# 在配置中引用
{
"mcpServers": {
"secure-server": {
"command": "node",
"args": ["server.js"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}
2. 权限最小化原则
{
"mcpServers": {
"readonly-db": {
"command": "npx",
"args": ["@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://readonly_user:pass@localhost:5432/db",
"ALLOWED_OPERATIONS": "SELECT"
}
}
}
}
5.3 开发环境vs生产环境配置
开发环境配置
{
"mcpServers": {
"dev-filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem"],
"env": {
"ALLOWED_DIRECTORIES": "/home/user/projects,/tmp",
"DEBUG": "true"
}
}
}
}
生产环境配置
{
"mcpServers": {
"prod-filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem"],
"env": {
"ALLOWED_DIRECTORIES": "/var/www/html",
"READONLY": "true",
"LOG_LEVEL": "error"
}
}
}
}
第六章：实战项目案例
6.1 项目一：全自动GitHub仓库管理
场景：自动化管理多个GitHub仓库，包括issue分类、PR审查、代码质量检查。
配置：
{
"mcpServers": {
"github-manager": {
"command": "npx",
"args": ["@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxx",
"GITHUB_REPOS": "user/repo1,user/repo2,org/repo3"
}
},
"code-quality": {
"command": "npx",
"args": ["@modelcontextprotocol/server-eslint"],
"env": {
"ESLINT_CONFIG": "/path/to/.eslintrc.json"
}
}
}
}
使用示例：
# 自动化工作流
用户：分析我的所有仓库中标记为"bug"的issue，按优先级排序
Claude：已分析3个仓库，发现27个bug issue：
- 高优先级：5个（影响核心功能）
- 中优先级：12个（影响用户体验）
- 低优先级：10个（小优化）
用户：为高优先级的issue创建修复计划
Claude：已创建修复计划，并在各仓库创建了对应的project board...
6.2 项目二：智能化前端开发流程
场景：结合Playwright进行自动化测试，文件系统操作进行代码管理。
配置：
{
"mcpServers": {
"frontend-dev": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem"],
"env": {
"ALLOWED_DIRECTORIES": "/home/user/frontend-projects"
}
},
"e2e-testing": {
"command": "npx",
"args": ["@playwright/mcp@latest"],
"env": {
"PLAYWRIGHT_BROWSERS_PATH": "/home/user/.cache/ms-playwright"
}
}
}
}
实际使用：
用户：检查我的React项目中所有组件是否遵循命名规范
Claude：正在扫描项目文件...
发现问题：
- ButtonComponent.jsx 应该重命名为 Button.jsx
- userCard.jsx 应该重命名为 UserCard.jsx
是否自动修正这些文件名？
用户：是的，并且更新所有相关的import语句
Claude：已完成重命名和import更新，运行测试验证...
所有测试通过
6.3 项目三：数据库运维自动化
场景：自动化数据库监控、优化建议、备份管理。
配置：
{
"mcpServers": {
"db-admin": {
"command": "npx",
"args": ["@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://admin:pass@localhost:5432/maindb",
"ALLOWED_OPERATIONS": "SELECT,EXPLAIN,SHOW"
}
},
"db-backup": {
"command": "python",
"args": ["/path/to/backup_server.py"],
"env": {
"BACKUP_PATH": "/var/backups/db",
"RETENTION_DAYS": "30"
}
}
}
}
第七章：故障排除与最佳实践
7.1 常见问题解决
问题1：MCP服务器启动失败
# 调试模式启动
claude --debug
# 检查特定服务器状态
claude mcp get server-name
# 查看日志
tail -f ~/.claude/logs/mcp.log
问题2：权限问题
# 检查文件权限
ls -la ~/.claude/.mcp.json
# 修复权限
chmod 600 ~/.claude/.mcp.json
问题3：性能问题
# 监控资源使用
claude mcp status --detailed
# 优化配置
claude mcp optimize
7.2 安全最佳实践
1. 定期审计配置
# 生成安全报告
claude mcp security-audit
# 检查过期token
claude mcp check-tokens
2. 备份配置
# 备份MCP配置
cp ~/.claude/.mcp.json ~/.claude/.mcp.json.backup.$(date +%Y%m%d)
# 版本控制配置（去除敏感信息）
claude mcp export-config --sanitize > mcp-config-template.json
第八章：延伸阅读
8.1 MCP服务器推荐
目前官方已支持的厂商包括Atlassian、Cloudflare、Intercom、Linear、PayPal、PLAID、Square、Wordato、Stripe、Sentry等
官方MCP列表传送门：https://www.anthropic.com/partners/mcp
苏米之前整理的一些优质的MCP服务器：
盘点 9 个 数据库MCP：Supabase、Neon、PostgreSQL、SQLite、MongoDB、MindsDB
用好这几款 MCP 工具，让你的Ai编程体验直接起飞（附用法）
8.2 开发自定义MCP服务器
开发者可以构建自己的服务器在Claude Desktop和其他客户端中使用。
可以看看一看苏米之前的一系列分享：
MCP实战：MCP Server + MCP Client 实现一个功能强大的 AI Agent
从零开始玩转MCP：手把手教你使用 MCP Server 快速搭建专属MCP Client
MCP实战：Mock数据，让AI项目调试接口变得更简单，别再让后端拖后腿！
结语
Claude Code + MCP的组合不仅仅是一个技术工具，它代表了AI辅助开发的新范式。通过这个指南，你已经掌握了从基础配置到高级定制的完整技能。
记住：Claude Code的最佳实践在各种代码库、语言和环境中都被证明是有效的。持续学习，保持实践，你将在AI驱动的开发时代中保持领先。
现在，开始你的Claude Code + MCP之旅吧！