模型上下文协议（MCP）

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

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

MCP 服务器可以用任何可以打印到stdout或提供 HTTP 端点服务的语言编写。这种灵活性使您可以使用自己喜欢的编程语言和技术栈快速实现 MCP 服务器。

实例

数据库

允许 Cursor 直接查询数据库，而无需手动输入模式或自己操作数据。

概念

从概念中读取数据，引导游标实现功能

GitHub

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

记忆

让Cursor在你工作时记忆和调用信息

条纹

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

架构

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

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

💻 stdio 传输

在本地机器上运行
由 Cursor 自动管理
直接通过stdout进行通信
只能由您本地访问

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

🌐 SSE 传输

可在本地或远程运行
由您管理和运行
通过网络通信
可跨机器共享

**输入：**指向 Cursor 外部 MCP 服务器/sse端点的 URL

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

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

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

配置 MCP 服务器

MCP 配置文件采用 JSON 格式，结构如下：

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

配置位置

根据使用情况，您可以将此配置放在两个位置：

项目配置

对于项目专用工具，请在项目目录中创建.cursor/mcp.json文件。这样就可以定义仅在特定项目中可用的 MCP 服务器。

全局配置

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

在聊天中使用 MCP

Composer Agent 会自动使用 MCP 设置页面 "可用工具"中列出的任何 MCP 工具，如果它认为这些工具是相关的。要有意提示工具的使用，只需告诉代理使用该工具，并通过名称或描述来提及该工具即可。

工具审批

默认情况下，当代理要使用 MCP 工具时，它会显示一条信息，要求您批准。您可以使用工具名称旁边的箭头展开消息，查看 Agent 调用工具时使用的参数。

自动运行

您可以启用自动运行，让 Agent 无需批准即可自动运行 MCP 工具，类似于终端命令的执行方式。点击此处了解更多有关 Yolo 模式以及如何启用该模式的信息。

工具响应

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

图像注入

使用某些 MCP 服务器时，Cursor 可能会运行一个返回图片的工具，如网站截图或图表。为使聊天能正确查看和使用回复中的图片，可以确保服务器配置为以正确格式返回图片。

为此，您只需在工具响应中返回图片的 base64 编码字符串即可。

有关 MCP 服务器返回图像的完整示例，请参见此处。

通过以这种格式返回图片，Cursor 会将图片附加到聊天中，如果当前模型支持这种格式，模型就会查看和分析图片，以帮助下一步操作。

局限性

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