Skip to main content
MCP 服务器(Model Context Protocol Server)是一种标准化插件,让 Claude Code 等 AI 工具能直接调用外部服务,无需手动复制粘贴数据。 这篇挑了 6 个在实际开发场景里最有用的 MCP 服务器,每个附安装命令和可直接用的配置片段。 还不清楚 MCP 是什么,先看 MCP 是什么?用一个类比彻底讲清楚模型上下文协议;想看真实使用场景,看 MCP 能做什么?10 个真实场景

装之前要知道的事

每个 MCP 服务器启动时会向 Claude Code 注册一批工具。同时启用的服务器越多,注入上下文的工具列表就越长,会占用 token 并拖慢响应。 建议同时启用不超过 6 个服务器。 按当前项目需要启用,不用的暂时注释掉。 配置文件路径:
客户端配置文件路径
Claude Desktop(macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop(Windows)%APPDATA%\Claude\claude_desktop_config.json
Cursor(项目级).cursor/mcp.json
Cursor(全局)~/.cursor/mcp.json

1. Brave Search MCP — 实时网页搜索

让 Claude Code 能搜索最新信息,告别”知识截止日期”限制。 适用场景: 查最新文档、搜技术方案、了解某个库的最新版本。 获取 API Key:Brave Search API 注册,免费计划每月 2000 次查询。
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

2. Context7 MCP — 拉取最新库文档

Claude Code 的训练数据有截止日期,写代码时经常用到过时的 API。Context7 在每次对话时实时拉取对应库的最新官方文档,直接注入上下文。 适用场景: 用 Claude Code 写代码时,自动获取 React、Next.js、Tailwind 等库的最新 API 说明。
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
使用方式:在 prompt 末尾加 use context7,Claude Code 会自动拉取相关库文档。

3. Filesystem MCP — 读写本地文件

让 Claude Code 直接访问你指定的本地目录,省去手动复制文件内容的步骤。 适用场景: 让 Claude Code 分析整个项目目录、批量修改文件、读取配置文件。
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/projects"
      ]
    }
  }
}
args 最后一个参数是授权目录,只填必要的目录,不要填根目录 /。可以填多个路径,空格分隔。

4. GitHub MCP — 读取仓库、Issue、PR

让 Claude Code 直接访问 GitHub 仓库内容,无需手动复制代码或 Issue 描述。 适用场景: 让 Claude Code 分析仓库代码、总结 Issue、查看 PR diff、理解项目结构。 获取 Token: GitHub Settings → Developer settings → Personal access tokens → 创建,只需要 repo 读权限。
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

5. Playwright MCP — 浏览器自动化

让 Claude Code 控制真实浏览器:打开网页、点击按钮、截图、填写表单。 适用场景: 自动化测试、网页截图、操作需要登录的页面、验证 UI 效果。
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}
首次运行会自动下载 Chromium(约 200MB),之后直接使用。

6. Fetch MCP — 抓取任意网页内容

让 Claude Code 直接抓取并解析任意 URL 的内容,返回干净的文本。 适用场景: 读取文档页面、抓取竞品信息、解析 API 响应页面。
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}
uvx 需要先安装 uvcurl -LsSf https://astral.sh/uv/install.sh | sh

完整配置示例

把上面的配置合并到一个文件里:
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

推荐组合

不想全装?按使用场景选: 开发场景(3 件套)
  • Context7:拉取最新库文档
  • Filesystem:读写本地项目目录
  • GitHub:访问仓库代码和 Issue
覆盖日常编码 80% 的需求。 信息检索(3 件套)
  • Brave Search:实时网页搜索
  • Fetch:抓取静态页面内容
  • Playwright:操控动态页面和截图
适合竞品分析、文档整理、自动化信息收集。

常见问题

需要完全退出再重启(macOS 需要从菜单栏退出,不只是关闭窗口)。重启后在新对话里才能使用新配置的 MCP 服务器。
打开 Claude Desktop,在新对话界面左下角或工具栏会显示已连接的 MCP 工具图标。也可以直接问 Claude:“你现在有哪些可用工具?”
确认 Node.js 版本 ≥ 18:node --version。如果版本过低,用 nvm 升级:nvm install 20 && nvm use 20
打开 Claude Desktop 日志(macOS:~/Library/Logs/Claude/),找对应服务器的错误信息。最常见的问题是环境变量没填或 API Key 错误。也可以用 MCP Inspector 单独测试某个服务器是否正常工作。

需要把 MCP 服务器部署到远程 VPS 供多人共享使用?看 在 VPS 上部署远程 MCP 服务器 本文最后更新于 2026-04,MCP 服务器版本以各仓库最新 release 为准。