# MCP Server 配置终极指南：Cursor、Claude Code、Windsurf 一网打尽 > **配置 MCP Server 总出问题？本文整理了 4 款主流 AI 编程工具的完整配置流程，手把手教你一次搞定。** ## 什么是 MCP Server？ MCP（Model Context Protocol）是 AI 编辑器与外部工具之间的通信协议。 简单说，**MCP Server 就是 AI 编辑器的「外挂插件库」**。安装后，你的 AI 编辑器就能： - 🌐 **搜索网页** — 实时获取互联网信息 - 📁 **读写文件** — 在项目目录中创建、编辑文件 - 🖥️ **执行命令** — 在终端中运行 Shell 命令 - 🔄 **处理 JSON** — 数据格式转换、验证 ## 推荐的 MCP Server 本文以 Hermes MCP Server 为例进行配置。它支持 13 个工具，覆盖日常开发所有高频场景。 ``` npm install -g hermes-mcp-server ``` > 💡 免费版包含 5 个基础工具，Pro 版（¥29 买断）解锁全部 13 个工具。 --- ## 一、在 Cursor 中配置 MCP Server ### 方式 A：全局配置 1. 打开 Cursor → 设置（Settings） 2. 搜索 MCP Server 3. 点击「Add MCP Server」 4. 写入以下配置： ```json { "mcpServers": { "hermes-mcp": { "command": "hermes-mcp", "args": [] } } } ``` ### 方式 B：项目级配置 在项目根目录创建 `.cursor/mcp.json`： ```json { "mcpServers": { "hermes-mcp": { "command": "npx", "args": ["-y", "hermes-mcp-server"] } } } ``` ### 验证 在 Cursor AI 对话框中输入：`用 web_search 工具搜索最新的 Node.js 版本` 如果返回了搜索结果，说明 MCP Server 配置成功 ✅ --- ## 二、在 Claude Code 中配置 MCP Server 配置 `~/.claude/settings.json`： ```json { "mcpServers": { "hermes-mcp": { "command": "hermes-mcp", "args": [] } } } ``` ### 验证 启动 Claude Code，输入：`用 web_search 搜索最新 Rust 特性` --- ## 三、在 Windsurf 中配置 MCP Server 配置文件：`~/.codeium/windsurf/mcp_config.json` ```json { "mcpServers": { "hermes-mcp": { "command": "hermes-mcp", "args": [] } } } ``` --- ## 四、在 Continue.dev 中配置 MCP Server 配置文件：项目根目录 `.continuerc.json` ```json { "experimental": { "mcpServers": { "hermes-mcp": { "command": "hermes-mcp", "args": [] } } } } ``` --- ## 安装命令汇总 | 方式 | 安装命令 | 适合场景 | |------|----------|----------| | 全局安装 | `npm install -g hermes-mcp-server` | 所有项目通用 | | npx 运行 | `npx -y hermes-mcp-server` | 临时使用 | | 项目依赖 | `npm install hermes-mcp-server` | 团队项目锁版本 | ## 常见问题 ### 连接失败 检查 Node.js 版本：`node --version`（需 ≥ 18） ### 工具调用报错 Pro 工具需要激活 Key： ``` mkdir -p ~/.hermes-mcp && echo "你的Pro-Key" > ~/.hermes-mcp/license.key ``` ### 找不到命令 重新全局安装：`npm install -g hermes-mcp-server` ## 总结 配置 MCP Server 其实很简单——一行命令安装，一段 JSON 配置。不管你在用 Cursor、Claude Code 还是 Windsurf，流程几乎一样。 > 🚀 Hermes MCP Server Pro — 13 个工具，支持 Cursor/Claude Code/Windsurf/Continue.dev，¥29 买断。