​
什么是 MCP？

Model Context Protocol（MCP） 让 Cursor 能连接到外部工具和数据源。

​
为什么使用 MCP？

MCP 把 Cursor 接入外部系统和数据。不必一遍遍解释你的项目结构，直接与你的工具集成就好。 你可以用任何能向 stdout 输出或提供 HTTP 端点的语言来编写 MCP 服务器——比如 Python、JavaScript、Go 等。

​
工作原理

MCP 服务器通过协议暴露能力，把 Cursor 连接到外部工具或数据源。 Cursor 支持三种传输方式：
TransportExecution environmentDeploymentUsersInputAuth
stdio本地Cursor 托管单用户Shell 命令手动
SSE本地/远程以服务器形式部署多用户SSE 端点的 URLOAuth
Streamable HTTP本地/远程以服务器形式部署多用户HTTP 端点的 URLOAuth

​
协议支持

Cursor 支持以下 MCP 协议能力：
FeatureSupportDescription
Tools支持供 AI 模型调用执行的函数
Prompts支持面向用户的模板化消息与工作流
Roots支持服务器发起的对 URI 或文件系统边界的探查，用于确定操作范围
Elicitation支持服务器发起的对用户补充信息的请求

​
安装 MCP 服务器

​
一键安装

从我们的集合中安装 MCP 服务器，并通过 OAuth 完成认证。

Browse MCP Tools

浏览可用的 MCP 服务器

Add to Cursor Button

创建 “Add to Cursor” 按钮

​
使用 mcp.json

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

​
使用 Extension API

如果需要以编程方式注册 MCP 服务器，Cursor 提供了 Extension API，可在无需修改 mcp.json 的情况下进行动态配置。对企业环境和自动化部署流程尤其实用。

MCP Extension API Reference

了解如何使用 vscode.cursor.mcp.registerServer() 以编程方式注册 MCP 服务器

​
配置位置

Project Configuration

在你的项目中创建 .cursor/mcp.json，用于项目级工具。

Global Configuration

在你的主目录创建 ~/.cursor/mcp.json，用于全局可用的工具。

​
身份验证

MCP 服务器通过环境变量进行身份验证。通过配置传递 API key 和 token。 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 Development 指南，里面演示了如何把 Linear、Figma 和浏览器工具集成到你的开发工作流中。

​
常见问题