Claude Code MCP 完整安装指南你需要掌握😏😏😏目录配置文件位置安装前准备两种安装方式推荐MC

📋 目录

配置文件位置

Mac / Linux

~/.claude.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

完整路径（Windows）：

C:\Users\你的用户名\AppData\Roaming\Claude\claude_desktop_config.json

安装前准备

1. 确认 Node.js 已安装

# 检查版本（需要 v16 或更高）
node --version
npm --version

# 如果没有安装：
# Mac: brew install node
# Ubuntu: sudo apt install nodejs npm
# Windows: 访问 https://nodejs.org 下载安装

2. 找到配置文件

Mac/Linux:

# 查看配置文件是否存在
ls -la ~/.claude.json

# 如果不存在，创建它
touch ~/.claude.json

Windows (PowerShell):

# 创建配置目录和文件
mkdir "$env:APPDATA\Claude" -Force
notepad "$env:APPDATA\Claude\claude_desktop_config.json"

Windows (文件管理器):

按 Win + R
输入：%APPDATA%\Claude
回车，如果文件夹不存在会提示创建

两种安装方式

⭐ 推荐方式：直接编辑配置文件

优点：

✅ 可以一次配置多个 MCP
✅ 避免 CLI 命令格式问题（尤其 Windows）
✅ 便于备份和管理
✅ 配置更直观

步骤：

打开配置文件

# Mac/Linux
vim ~/.claude.json
# 或
code ~/.claude.json

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json
# 或
code %APPDATA%\Claude\claude_desktop_config.json

粘贴配置（见下方示例）
保存文件
重启 Claude Code
验证

# 在 Claude Code 中输入
/mcp

备选方式：使用 CLI 命令

注意：CLI 命令格式必须完全正确！

⚠️ 正确的 CLI 格式

# 基本格式（注意 -- 双横线）
claude mcp add <名称> --scope user -- <完整命令>

# 示例
claude mcp add sequential-thinking --scope user -- npx -y @modelcontextprotocol/server-sequential-thinking

重点：

--scope user 后面必须加 --（双横线）
然后跟完整的 npx 命令
Windows 用户推荐用配置文件方式，避免转义字符问题

推荐 MCP 服务

每个服务提供 CLI 命令（正确格式）和 配置代码，推荐直接用配置代码！

🔥 必装组合（适合所有开发者）

1. GitHub - 代码协作

功能： 创建PR、管理Issues、触发CI/CD

CLI 安装：

claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
# 然后会提示输入 GITHUB_PERSONAL_ACCESS_TOKEN

配置代码（推荐）：

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

获取 GitHub Token：

访问 github.com/settings/to…
点击 "Generate new token (classic)"
勾选权限：repo, workflow, read:org
生成并复制 token（格式：ghp_xxxxx）

使用示例：

"查看仓库最近的 PR"
"创建一个 PR 修复 issue #123"
"列出所有打开的 issues"

2. Sequential Thinking - 任务分解

功能： 将复杂任务分解为多个步骤

CLI 安装：

claude mcp add sequential-thinking --scope user -- npx -y @modelcontextprotocol/server-sequential-thinking

配置代码（推荐）：

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

无需 API Key

使用示例：

"制定重构用户认证模块的详细计划"
"分析如何优化数据库查询性能"

3. Filesystem - 本地文件访问

功能： 读取和分析本地项目文件

CLI 安装：

# Mac/Linux
claude mcp add filesystem --scope user -- npx -y @modelcontextprotocol/server-filesystem /Users/yourname/projects

# Windows
claude mcp add filesystem --scope user -- npx -y @modelcontextprotocol/server-filesystem C:\Users\yourname\projects

配置代码（推荐）：

"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "/Users/yourname/projects"
  ]
}

Windows 路径注意：

// Windows 用户，路径用正斜杠或双反斜杠
"C:/Users/yourname/projects"
// 或
"C:\\Users\\yourname\\projects"

使用示例：

"分析项目的整体架构"
"找出所有使用了某个函数的地方"

🔍 信息查询类

4. Context7 - 官方文档查询

功能： 获取实时的官方技术文档

CLI 安装：

claude mcp add context7 --scope user -- npx -y context7-mcp

配置代码（推荐）：

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

无需 API Key

使用示例：

"查询 TypeScript 5.0 的新功能"
"React 18 的 Suspense 怎么用？"

5. Brave Search - 实时网络搜索

功能： 搜索最新技术文档和解决方案

CLI 安装：

claude mcp add brave-search --scope user -- npx -y @modelcontextprotocol/server-brave-search
# 会提示输入 BRAVE_API_KEY

配置代码（推荐）：

"brave-search": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-brave-search"],
  "env": {
    "BRAVE_API_KEY": "BSA_你的key"
  }
}

获取 API Key：

访问 brave.com/search/api/
注册账号
创建 API Key（免费版每月 2000 次请求）

6. Perplexity Search - AI 增强搜索

CLI 安装：

claude mcp add perplexity --scope user -- npx -y perplexity-mcp

配置代码（推荐）：

"perplexity": {
  "command": "npx",
  "args": ["-y", "perplexity-mcp"],
  "env": {
    "PERPLEXITY_API_KEY": "pplx_你的key"
  }
}

获取 API Key： www.perplexity.ai/settings/ap…

🧪 测试开发类

7. Playwright - 浏览器自动化

功能： 自动化测试、网页截图、爬虫

CLI 安装：

claude mcp add playwright --scope user -- npx -y @modelcontextprotocol/server-playwright

配置代码（推荐）：

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

无需 API Key

使用示例：

"用 playwright 打开 https://example.com 并截图"
"测试登录功能是否正常"

🛠️ 项目管理类

8. Linear - 任务管理

CLI 安装：

claude mcp add linear --scope user -- npx -y @linear/mcp

配置代码（推荐）：

"linear": {
  "command": "npx",
  "args": ["-y", "@linear/mcp"],
  "env": {
    "LINEAR_API_KEY": "lin_api_你的key"
  }
}

获取 API Key： Linear Settings → API → Personal API keys

9. Jira (Atlassian) - 企业任务管理

CLI 安装：

claude mcp add jira --scope user -- npx -y @atlassian/mcp-server-jira

配置代码（推荐）：

"jira": {
  "command": "npx",
  "args": ["-y", "@atlassian/mcp-server-jira"],
  "env": {
    "ATLASSIAN_INSTANCE_URL": "https://your-domain.atlassian.net",
    "ATLASSIAN_USERNAME": "your-email@example.com",
    "ATLASSIAN_API_TOKEN": "你的token"
  }
}

获取 API Token： id.atlassian.com/manage-prof…

10. Sentry - 错误监控

CLI 安装：

claude mcp add sentry --scope user -- npx -y @sentry/mcp-server

配置代码（推荐）：

"sentry": {
  "command": "npx",
  "args": ["-y", "@sentry/mcp-server"],
  "env": {
    "SENTRY_AUTH_TOKEN": "你的token",
    "SENTRY_ORG_SLUG": "your-org",
    "SENTRY_PROJECT_SLUG": "your-project"
  }
}

💾 数据库类

11. PostgreSQL - 数据库查询

CLI 安装：

claude mcp add postgres --scope user -- npx -y @modelcontextprotocol/server-postgres

配置代码（推荐）：

"postgres": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-postgres"],
  "env": {
    "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/database"
  }
}

12. SQLite - 轻量数据库

CLI 安装：

# Mac/Linux
claude mcp add sqlite --scope user -- npx -y @modelcontextprotocol/server-sqlite /path/to/database.db

# Windows
claude mcp add sqlite --scope user -- npx -y @modelcontextprotocol/server-sqlite C:/path/to/database.db

配置代码（推荐）：

"sqlite": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
}

🎨 设计协作类

13. Figma - 设计文件访问

CLI 安装：

claude mcp add figma --scope user -- npx -y @figma/mcp-server

配置代码（推荐）：

"figma": {
  "command": "npx",
  "args": ["-y", "@figma/mcp-server"],
  "env": {
    "FIGMA_ACCESS_TOKEN": "你的token"
  }
}

获取 Token： Figma → Settings → Account → Personal access tokens

🐳 DevOps 类

14. Docker - 容器管理

CLI 安装：

claude mcp add docker --scope user -- npx -y @modelcontextprotocol/server-docker

配置代码（推荐）：

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

完整配置示例

🎯 初学者配置（3个MCP）

文件路径：

Mac/Linux: ~/.claude.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

配置内容：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_你的token"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}

安装步骤（推荐）：

复制上面的配置
打开配置文件（Mac: ~/.claude.json / Windows: notepad %APPDATA%\Claude\claude_desktop_config.json）
粘贴配置，替换你的 GitHub Token
保存文件
重启 Claude Code
输入 /mcp 验证

🚀 专业开发者配置（7个MCP）

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/projects"
      ]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxxx"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    },
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp"],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxx"
      }
    }
  }
}

Windows 用户注意修改 filesystem 路径：

"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "C:/Users/yourname/projects"
  ]
}

💼 企业全栈配置（10个MCP）

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/projects"
      ]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxxx"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@atlassian/mcp-server-jira"],
      "env": {
        "ATLASSIAN_INSTANCE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_USERNAME": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "xxxxx"
      }
    },
    "sentry": {
      "command": "npx",
      "args": ["-y", "@sentry/mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "xxxxx",
        "SENTRY_ORG_SLUG": "your-org",
        "SENTRY_PROJECT_SLUG": "your-project"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/db"
      }
    },
    "figma": {
      "command": "npx",
      "args": ["-y", "@figma/mcp-server"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "xxxxx"
      }
    }
  }
}

🪟 Windows 用户专用一键配置脚本

方法一：PowerShell 脚本（推荐）

创建文件 setup-mcp.ps1：

# 创建配置目录
$configDir = "$env:APPDATA\Claude"
$configFile = "$configDir\claude_desktop_config.json"

Write-Host "🚀 开始配置 Claude Code MCP..." -ForegroundColor Green

# 确保目录存在
New-Item -ItemType Directory -Force -Path $configDir | Out-Null

# 配置内容（初学者版本）
$config = @"
{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}
"@

# 写入配置文件
$config | Out-File -FilePath $configFile -Encoding UTF8

Write-Host ""
Write-Host "✅ MCP 配置完成！" -ForegroundColor Green
Write-Host "📂 配置文件位置: $configFile" -ForegroundColor Cyan
Write-Host ""
Write-Host "📝 下一步操作：" -ForegroundColor Yellow
Write-Host "  1. 重启 Claude Code" -ForegroundColor White
Write-Host "  2. 在 Claude Code 中输入: /mcp" -ForegroundColor White
Write-Host "  3. 查看是否显示 3 个已连接的服务" -ForegroundColor White
Write-Host ""
Write-Host "💡 如需添加 GitHub，请编辑配置文件添加 Token" -ForegroundColor Yellow

# 询问是否打开配置文件
$open = Read-Host "是否现在打开配置文件进行编辑？(Y/N)"
if ($open -eq "Y" -or $open -eq "y") {
    notepad $configFile
}

运行脚本：

# 在 PowerShell 中执行
powershell -ExecutionPolicy Bypass -File setup-mcp.ps1

方法二：直接复制粘贴

打开 PowerShell
创建配置目录和文件

mkdir "$env:APPDATA\Claude" -Force
notepad "$env:APPDATA\Claude\claude_desktop_config.json"

粘贴配置（初学者版本）

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}

保存文件（Ctrl+S）
重启 Claude Code

使用方法

1. 验证安装

# 在 Claude Code 中输入
/mcp

# 期望输出：
# ✔ Found 3 MCP servers
#   • sequential-thinking: connected
#   • context7: connected
#   • playwright: connected

2. 自然语言使用

直接对话，不需要特殊命令：

# GitHub
"查看我的仓库列表"
"创建 PR 修复 bug #42"

# Context7
"React Hooks 的使用规则是什么？"
"TypeScript 泛型怎么写？"

# Playwright
"打开 https://example.com 并截图"
"测试表单提交功能"

# Sequential Thinking
"帮我制定重构用户系统的计划"

# 组合使用
"根据 Jira ISSUE-123 实现功能，完成后创建 GitHub PR"

3. 查看可用命令

# 在 Claude Code 中
/help

# 查看特定 MCP 的信息
claude mcp get github

常见问题

Q1: CLI 报错 "missing required argument 'commandOrUrl'"

原因： CLI 命令格式不对，缺少 -- 分隔符

错误示例：

❌ claude mcp add sequential-thinking --scope user

正确示例：

✅ claude mcp add sequential-thinking --scope user -- npx -y @modelcontextprotocol/server-sequential-thinking

最佳解决方案： 不用 CLI，直接编辑配置文件！

Q2: 配置文件在哪里？找不到

Mac/Linux：

# 查找文件
ls -la ~/.claude.json

# 如果不存在，创建它
touch ~/.claude.json
vim ~/.claude.json

Windows：

# 在文件管理器地址栏输入
%APPDATA%\Claude

# 或者用命令创建
mkdir "$env:APPDATA\Claude" -Force
notepad "$env:APPDATA\Claude\claude_desktop_config.json"

Q3: MCP 连接失败？

检查步骤：

重启 Claude Code

# 配置更改后必须重启

检查 JSON 格式

// ❌ 错误：最后一项有逗号
{
  "mcpServers": {
    "github": { ... },
    "context7": { ... },  // ← 这个逗号要删除
  }
}

// ✅ 正确
{
  "mcpServers": {
    "github": { ... },
    "context7": { ... }
  }
}

检查路径

// Windows 用户注意路径格式
"C:/Users/yourname/projects"  // ✅ 正斜杠
"C:\\Users\\yourname\\projects"  // ✅ 双反斜杠
"C:\Users\yourname\projects"  // ❌ 单反斜杠会报错

查看日志

# Mac/Linux
tail -f ~/.claude/logs/*.log

# Windows
# 查看 %APPDATA%\Claude\logs 目录

测试单个服务

claude mcp get context7

Q4: API Key 无效？

检查清单：

✅ Token 是否正确复制（没有多余空格）
✅ 权限是否足够
✅ Token 是否过期
✅ 配置文件格式是否正确
✅ Token 是否加了引号

// ✅ 正确
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"

// ❌ 错误：没加引号
"GITHUB_PERSONAL_ACCESS_TOKEN": ghp_xxxxx

Q5: npx 报错或下载很慢？

解决方案：

# 1. 确认 Node.js 版本
node --version  # 需要 >= v16

# 2. 切换 npm 镜像（中国用户）
npm config set registry https://registry.npmmirror.com

# 3. 清除 npx 缓存
npx clear-npx-cache

# 4. 手动安装（不推荐，但可以试试）
npm install -g @modelcontextprotocol/server-github

Q6: 如何更新 MCP？

方法一（推荐）：

# npx 会自动使用最新版本
# 只需清除缓存，重启 Claude Code
npx clear-npx-cache

方法二：

# CLI 删除后重新添加
claude mcp remove github
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github

Q7: 如何临时禁用某个 MCP？

方法一：注释掉

{
  "mcpServers": {
    // "github": {
    //   "command": "npx",
    //   "args": ["-y", "@modelcontextprotocol/server-github"]
    // },
    "context7": { ... }
  }
}

方法二：删除

claude mcp remove github

Q8: 多个项目不同配置？

Claude Code 支持项目级别配置：

{
  "projects": {
    "/path/to/project-a": {
      "mcpServers": {
        "github": { ... },
        "postgres": { ... }
      }
    },
    "/path/to/project-b": {
      "mcpServers": {
        "figma": { ... },
        "playwright": { ... }
      }
    }
  }
}

Windows 路径：

{
  "projects": {
    "C:/Users/yourname/projects/project-a": {
      "mcpServers": { ... }
    }
  }
}

Q9: Windows 上 Gitee/GitCode 怎么用？

GitHub MCP 不支持 Gitee/GitCode，但可以用 Filesystem + Git 命令：

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

然后对 Claude 说：

"帮我提交代码到 Gitee"
"创建新分支并推送到 GitCode"

Claude 会使用 git 命令完成操作。

Q10: Token 消耗会增加多少？

对比：

场景	不用MCP	使用MCP	增加倍数
简单问答	200 tokens	200 tokens	1x
查文档	500 tokens	1,200 tokens	2.4x
复杂任务	1,000 tokens	3,500 tokens	3.5x
自动化	2,000 tokens	8,000 tokens	4x

节省 Token 技巧：

只安装常用的 5-7 个
临时不用的可以注释掉
明确指令，避免多次调用

按场景推荐

🎨 前端开发者

# 推荐这 4 个
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
claude mcp add playwright --scope user -- npx -y @modelcontextprotocol/server-playwright
claude mcp add context7 --scope user -- npx -y context7-mcp
claude mcp add figma --scope user -- npx -y @figma/mcp-server

⚙️ 后端开发者

# 推荐这 4 个
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
claude mcp add sequential-thinking --scope user -- npx -y @modelcontextprotocol/server-sequential-thinking
claude mcp add postgres --scope user -- npx -y @modelcontextprotocol/server-postgres
claude mcp add sentry --scope user -- npx -y @sentry/mcp-server

🌐 全栈开发者

# 推荐这 5 个
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
claude mcp add filesystem --scope user -- npx -y @modelcontextprotocol/server-filesystem ~/projects
claude mcp add playwright --scope user -- npx -y @modelcontextprotocol/server-playwright
claude mcp add brave-search --scope user -- npx -y @modelcontextprotocol/server-brave-search
claude mcp add linear --scope user -- npx -y @linear/mcp

🛠️ DevOps 工程师

# 推荐这 3 个
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
claude mcp add docker --scope user -- npx -y @modelcontextprotocol/server-docker
claude mcp add sentry --scope user -- npx -y @sentry/mcp-server

最佳实践

1. 从少到多

# 第一周：只装 3 个基础的
sequential-thinking, context7, playwright

# 第二周：加上项目协作
+ github, filesystem

# 第三周：根据需要添加
+ linear/jira, sentry, 等

2. 保护密钥

# 永远不要提交配置文件到 Git
echo ".claude.json" >> ~/.gitignore
echo "claude_desktop_config.json" >> .gitignore

3. 定期备份

# Mac/Linux
cp ~/.claude.json ~/.claude.json.backup

# Windows
copy "%APPDATA%\Claude\claude_desktop_config.json" "%APPDATA%\Claude\claude_desktop_config.json.backup"

4. 版本控制（团队推荐）

# 创建一个模板文件（不含密钥）
# claude.json.template

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

快速开始建议

新手（第一天）

只装这 3 个（无需 API Key）：

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}

进阶（第一周）

加上 GitHub 和 Filesystem：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_你的token"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/your/project/path"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}

资源链接

MCP 服务目录： github.com/modelcontex…
Claude Code 文档： docs.claude.com/en/docs/cla…
MCP 规范： modelcontextprotocol.io
社区讨论： discord.gg/anthropic
问题反馈： github.com/anthropics/…

💡 小技巧

用配置文件，不用 CLI - 尤其 Windows 用户
从 3 个开始 - 不要一次装太多
定期清理 - 删除不用的 MCP
备份配置 - 防止配置丢失
监控 Token - 用 /context 查看使用情况
项目隔离 - 不同项目配置不同的 MCP

现在就开始配置你的第一个 MCP 吧！ 🚀

推荐流程：

打开配置文件（Windows: notepad %APPDATA%\Claude\claude_desktop_config.json）
粘贴"新手配置"（3个MCP，无需API Key）
保存并重启 Claude Code
输入 /mcp 验证
开始体验增强版 Claude Code！