​
什么是 MCP？

Model Context Protocol (MCP) 使 Cursor 能够连接到外部工具和数据源。

​
为什么使用 MCP？

MCP 将 Cursor 连接到外部系统和数据。无需重复解释您的项目结构，直接与您的工具集成。 使用任何能够打印到 stdout 或提供 HTTP 端点的语言编写 MCP 服务器 - Python、JavaScript、Go 等。

​
工作原理

MCP 服务器通过协议公开功能，将 Cursor 连接到外部工具或数据源。 Cursor 支持三种传输方法：
传输方式执行环境部署用户输入认证
stdio本地Cursor 管理单用户Shell 命令手动
SSE本地/远程部署为服务器多用户SSE 端点的 URLOAuth
Streamable HTTP本地/远程部署为服务器多用户HTTP 端点的 URLOAuth

​
安装 MCP 服务器

​
一键安装

从我们的集合中安装 MCP 服务器并通过 OAuth 进行身份验证。

浏览 MCP 工具

浏览可用的 MCP 服务器

添加到 Cursor 按钮

创建”添加到 Cursor”按钮

​
使用 mcp.json

使用 JSON 文件配置自定义 MCP 服务器： 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
配置位置

项目配置

在项目中创建 .cursor/mcp.json 用于项目特定的工具。

全局配置

在主目录中创建 ~/.cursor/mcp.json 用于随处可用的工具。

​
身份验证

MCP 服务器使用环境变量进行身份验证。通过配置传递 API 密钥和令牌。 Cursor 支持需要 OAuth 的服务器。

​
在聊天中使用 MCP

Composer Agent 会在相关时自动使用 Available Tools 下列出的 MCP 工具。通过名称请求特定工具或描述您的需求。可以从设置中启用或禁用工具。

​
切换工具

直接从聊天界面启用或禁用 MCP 工具。点击工具列表中的工具名称来切换它。禁用的工具不会加载到上下文中，也不会对 Agent 可用。

​
工具批准

默认情况下，Agent 在使用 MCP 工具之前会请求批准。点击工具名称旁边的箭头查看参数。

​
自动运行

启用自动运行让 Agent 无需询问即可使用 MCP 工具。工作方式类似终端命令。在这里了解更多关于 Yolo 模式的信息。

​
工具响应

Cursor 在聊天中显示响应，并提供参数和响应的可展开视图：

​
图像作为上下文

MCP 服务器可以返回图像 - 截图、图表等。将它们作为 base64 编码字符串返回： 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ 为了可读性，完整的 base64 已被截断

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
查看这个示例服务器了解实现细节。Cursor 将返回的图像附加到聊天中。如果模型支持图像，它会分析这些图像。

​
安全注意事项

在安装 MCP 服务器时，请考虑以下安全实践：
  • 验证来源：仅从可信的开发者和代码库安装 MCP 服务器
  • 检查权限：查看服务器将访问哪些数据和 API
  • 限制 API 密钥：使用具有最小必需权限的受限 API 密钥
  • 审计代码：对于关键集成，请审查服务器的源代码
请记住，MCP 服务器可以访问外部服务并代表您执行代码。在安装之前，请务必了解服务器的功能。

​
实际应用示例

有关 MCP 实际应用的实用示例，请参阅我们的Web 开发指南，该指南演示了如何将 Linear、Figma 和浏览器工具集成到您的开发工作流程中。

​
常见问题