​
什么是 MCP？

模型上下文协议 （MCP） 是一种开放协议，它标准化了应用程序向 LLM 提供上下文和工具的方式。将 MCP 想象成 Cursor 的插件系统 - 它允许您通过标准化接口将代理连接到各种数据源和工具，从而扩展代理的功能。

了解有关 MCP 的更多信息

访问官方 MCP 文档以深入了解协议

​
使用

MCP 允许您将 Cursor 连接到外部系统和数据源。这意味着您可以将 Cursor 与现有工具和基础设施集成，而不必告诉 Cursor 您的项目结构在代码本身之外是什么。

MCP 服务器可以用任何可以打印到的语言编写stdout或提供 HTTP 端点。这种灵活性使您能够使用首选编程语言和技术堆栈非常快速地实施 MCP 服务器。

​
例子

数据库

允许 Cursor 直接查询您的数据库，而不是手动输入架构或自己作数据。

概念

从 概念中读取数据以引导光标实现功能

GitHub

让 Cursor 创建 PR、创建分支、查找代码等

存储

允许 Cursor 在您工作时记住和调用信息

Stripe

允许 Cursor 创建客户、管理订阅等

​
Architecture

MCP 服务器是通过标准化协议公开特定功能的轻量级程序。它们充当 Cursor 与外部工具或数据源之间的中介。

Cursor 支持 MCP 服务器的两种传输类型：

💻 stdio 传输

- 在本地计算机上
运行 - 由 Cursor
自动管理 - 通过stdout
- 只能由您本地

访问 输入：由 Cursor 自动运行的有效 shell 命令

🌐 SSE 传输

- 可以在本地或远程
运行 - 由您
管理和运行 - 通过网络
通信 - 可以在计算机

之间共享 输入：指向/sseCursor 外部的 MCP 服务器的端点

对于 stdio 服务器，该命令应该是 Cursor 可以运行的有效 shell 命令。

对于 SSE 服务器，URL 应该是 SSE 端点的 URL，例如 http://example.com:8000/sse。

每种传输类型都有不同的用例，stdio 更适合本地开发，而 SSE 为分布式团队提供了更大的灵活性。

​
配置 MCP 服务器

MCP 服务器可以通过三种方式进行配置，按推荐顺序列出。所有配置方法都使用相同的 JSON 格式：

​
配置格式

MCP 配置文件使用具有以下结构的 JSON 格式：

// This example demonstrated an MCP server using the stdio format
// Cursor automatically runs this process for you
// This uses a Node.js server, ran with `npx`
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

这env字段允许您指定可用于 MCP 服务器进程的环境变量。这对于管理 API 密钥和其他敏感配置特别有用。

​
配置位置

您可以将此配置放置在两个位置，具体取决于您的使用案例：

项目配置

对于特定于项目的工具，请创建一个.cursor/mcp.json文件。这允许您定义仅在该特定项目中可用的 MCP 服务器。

全局配置

对于要在所有项目中使用的工具，请创建一个~/.cursor/mcp.json文件。这使得 MCP 服务器在所有 Cursor 工作区中都可用。

虽然您可以通过 UI 添加 MCP 服务器，但不建议使用此方法，因为它不支持环境变量，并且需要为每个工作区手动配置。

要通过 UI 添加 MCP 服务器，请执行以下作：

  1. 转到Cursor Settings > Features > MCP
  2. 点击+ Add New MCP Server
  3. 填写表格：
    • 选择传输类型（stdio 或 SSE）
    • 输入服务器名称
    • 对于 stdio：输入要运行的命令（例如node ~/mcp-quickstart/weather-server-typescript/build/index.js)
    • 对于 SSE：输入 SSE 终端节点 URL（例如http://localhost:8765/sse)
stdio 服务器
SSE 服务器

添加服务器后，它将出现在您的 MCP 服务器列表中。
您可能需要单击刷新按钮来加载可用工具。

​
在 Agent 中使用 MCP 工具

Composer 代理将自动使用Available Tools在 MCP 设置页面上，如果它确定它们是相关的。 要有意提示使用工具，只需告诉代理使用该工具，通过名称或描述引用它。

​
工具批准

默认情况下，当 Agent 想要使用 MCP 工具时，它将显示一条消息，请求您的批准。您可以使用工具名称旁边的箭头展开消息，并查看使用哪些参数将 Agent 称为该工具。

​
Yolo 模式

您可以启用 Yolo 模式以允许 Agent 自动运行 MCP 工具而无需批准，类似于执行终端命令的方式。在此处阅读有关 Yolo 模式以及如何启用它的更多信息。

​
工具响应

使用工具时，Cursor 将在聊天中显示响应。 此图显示了示例工具的响应，以及工具调用参数和工具调用响应的扩展视图。

​
局限性

MCP 是一个非常新的协议，目前仍在积极开发中。有一些已知的注意事项需要注意：

忽略文件计划和使用情况