Cursor MCP 功能详解与实战配置

Posted 2025-03-26 Updated 22 days ago

By Eric

20~26 min read

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

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

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

https://www.bilibili.com/video/BV1KC5KzEE4x/?vd_source=d49dc28da5a9b890881115833378eb26

什么是 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 辅助编程的更多可能性。