Cursor MCP 功能详解与实战配置

Posted 昨天 Updated 昨天

By Eric

27~34 min read

见字如面，与大家分享实践中的经验与思考。

随着人工智能编程工具的快速发展，Cursor 作为一款基于 AI 的新一代代码编辑器，凭借其强大的智能辅助功能正受到越来越多开发者的青睐。其中 MCP (Model Context Protocol) 功能作为 Cursor 的重要扩展能力，允许开发者为 AI 提供外部工具和服务的访问权限，极大地增强了编码效率和智能化程度。

本文将详细介绍 Cursor MCP 的基本概念、配置方法以及实际应用场景，帮助你充分释放 Cursor 的潜力，提升开发体验。无论你是 Cursor 新手还是有经验的用户，相信都能从中获得有价值的信息。

什么是 MCP？

MCP (Model Context Protocol) 是一种允许 AI 模型与外部工具和服务交互的协议。在 Cursor 中，MCP 使 AI 能够访问外部资源、执行特定操作，从而增强 AI 的能力范围。

典型的 MCP 功能包括但不限于：

网络搜索
GitHub 集成
API 调用
数据库查询
特定工具集成

MCP 协议详解，请参考文章：MCP 协议：AI 世界的"USB-C接口"

Cursor 配置 MCP Server

在 Cursor 中添加 MCP Server 有两种配置方式：

全局设置：通过 Cursor Settings -> MCP -> Add new global MCP server 添加全局可用的 MCP 服务。
项目级别：在项目目录的 .cursor 目录中新建 mcp.json 文件进行配置，仅对特定项目生效。

注意：推荐使用项目级别配置，因为全局模式会在所有项目中生效，可能在某些情况下影响 Cursor Agent 的输出质量。

快速配置步骤

以 Smithery.ai 为例，我们可以通过以下步骤添加几个常用的 MCP 服务进行测试：

方法一：通过 npx 命令安装

可以使用命令行安装 MCP 服务（具体命令请参考 Smithery 网站上的指导）。

image-20250322下午31749421

方法二：配置 JSON 文件（推荐）

我个人更喜欢采用 JSON 配置方式，步骤如下：

在项目根目录创建 .cursor 文件夹（如果不存在）
在该文件夹中创建 mcp.json 文件
添加以下内容（以 Brave 搜索和 GitHub 集成为例）：

{
  "mcpServers": {
    "@smithery-ai-brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@smithery-ai/brave-search",
        "--config",
        "{\"braveApiKey\":\"xxx\"}"
      ]
    },
    "@smithery-ai-github": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@smithery-ai/github",
        "--config",
        "{\"githubPersonalAccessToken\":\"xxx\"}"
      ]
    }
  }
}

重要提示：需要将配置中的 xxx 替换为你自己的 API 密钥。如需获取 Brave API Key，可访问 Brave API 网站；GitHub Personal Access Token 可在 GitHub 设置中创建。

image-20250322下午31417145

验证 MCP 服务是否生效

完成配置后，需要确认 MCP 服务已正确启用：

在 Cursor 中打开 Settings -> MCP
检查你配置的 MCP Server 是否在列表中显示，并确认有绿点且状态为Enabled

image-20250322下午32428289

实际使用示例

使用 Agent 模式进行提问，测试 MCP 功能是否正常工作：

image-20250322下午33325971

使用技巧与注意事项

明确提示词：Cursor 匹配 MCP 工具并不总是稳定，因为它自带网络搜索功能。在提示词中明确提及使用特定 MCP 工具可提高调用成功率。
排查问题：如果 MCP 服务未正常工作，可以：
- 检查 API 密钥是否正确
- 确认 MCP 服务状态是否为 Enabled
- 查看 Cursor 控制台日志是否有错误信息
定期更新：MCP 生态系统发展迅速，建议定期检查更新以获取新功能。

最后

通过合理配置和使用 Cursor MCP 功能，我们可以显著增强 AI 编码助手的能力，使其能够访问外部资源、调用专业工具，从而提供更精准、更高效的编程辅助。希望本文对你理解和应用 Cursor MCP 有所帮助，让我们共同探索 AI 辅助编程的更多可能性。