Skip to content

MCP 服务器配置教程

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议,让 Claude Code 能够连接外部工具和数据源,大幅扩展 AI 的能力边界。

MCP 让 Claude Code 能够:

  • 访问最新的库和框架文档(如 Context7)
  • 操作 GitHub、Notion、Figma 等外部服务
  • 执行浏览器自动化、数据库查询等任务
  • 连接 Zapier 等自动化平台实现跨应用工作流

配置文件位置

级别路径
全局 (macOS/Linux)~/.claude/mcp.json
全局 (Windows)%USERPROFILE%\.claude\mcp.json
项目级别.claude/mcp.json

安装方式

方式一:命令行安装(推荐)

使用 Claude Code 内置命令管理 MCP 服务器:

# 本地运行(npx)
claude mcp add <name> -- npx -y <package>

# 远程连接(HTTP)
claude mcp add --transport http <name> <url>

# 查看已安装
claude mcp list

# 移除服务器
claude mcp remove <name>

方式二:手动配置

直接编辑 ~/.claude/mcp.json 文件:

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

热门 MCP 服务器

开发工具

Context7 - 获取最新的库和框架文档、API 信息、代码示例

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

GitHub - 访问 GitHub 仓库、Issue、PR,支持代码搜索和文件操作

npx @composio/mcp@latest setup github --client claude

Docker - 容器生命周期管理、镜像构建、Docker Compose 编排

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

Sequential Thinking - 链式思维推理、逐步问题解决、复杂任务分析

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

Filesystem - 本地文件读写、目录操作

claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

生产力工具

Notion - 访问和管理 Notion 工作区、搜索页面、创建笔记、更新数据库

npx @composio/mcp@latest setup notion --client claude

Slack - 读取和发送消息、搜索频道和用户、文件共享、线程管理

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

Linear - 创建和更新 Issue、项目查询、Sprint 规划、状态跟踪

claude mcp add --scope user linear -- npx -y linear-mcp-server

Figma - 访问设计文件、导出资源、分析设计系统、组件分析

npx @composio/mcp@latest setup figma --client claude

数据库

Supabase - PostgreSQL 数据库访问、身份验证、存储和文件操作

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

PostgreSQL - SQL 查询执行、模式检查、连接池、只读模式

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

SQLite - 轻量级数据库操作、本地数据存储

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

自动化

Playwright - 浏览器自动化和网页抓取,支持截图、表单填写、数据提取

claude mcp add --scope user playwright -- npx -y @executeautomation/mcp-playwright

Puppeteer - 无头浏览器控制、网页抓取、PDF 生成、表单自动化

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

Zapier - 连接 5000+ 应用、Zap 创建和管理、工作流自动化

npx @composio/mcp@latest setup zapier --client claude

Context7 详细教程

Context7 是最受欢迎的 MCP 服务器之一,可以让 Claude Code 访问最新的库和框架文档,避免使用过时的 API。

安装方式一:远程连接(推荐)

claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"

安装方式二:本地运行

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

使用方法 - 在提示词中加入 use context7 即可让 Claude Code 查询最新文档:

用 Vue 3 创建一个响应式表单组件 use context7

注意事项

  • 每个项目启用的 MCP 不要超过 10 个,活跃工具不超过 80 个
  • 200k 上下文窗口可能因工具过多缩减至 70k
  • 需要 API Key 的服务器请替换 YOUR_API_KEY 为实际密钥
  • 部分 MCP 服务器需要额外安装依赖,请参考各自的官方文档

更多资源