Cursor 官方文档中文版
  1. 上下文管理
Cursor 官方文档中文版
  • 快速入门
    • 简介
    • 安装
    • 常见问题 (FAQ)
  • 使用手册
    • 编辑器迁移
      • 从 VS Code 迁移
      • 从 JetBrains IDE 迁移
    • 支持的语言与框架
      • JavaScript 与 TypeScript
      • iOS 与 macOS(Swift)
      • Java
  • 编辑器
    • AI 生成提交信息
    • 记事本功能(Beta)
    • 键盘快捷键
    • 标签页管理
      • 概述
      • 标签页 vs GitHub Copilot
      • 自动导入依赖
      • 高级功能
    • 智能会话 (Chat)
      • 概述
      • 智能体模式
      • 问答模式
      • 自定义模式
      • 工具集
      • 应用更改
    • ⌘K
      • 概述
      • 终端命令(Cmd+K)
  • 上下文管理
    • 代码库索引
    • AI 行为规则
    • 忽略文件配置
    • 上下文协议 (Model Context Protocol)
    • @ Symbols
      • Overview
      • @Files
      • @Folders
      • @Code
      • @Docs
      • @Git
      • @Web
      • @Definitions
      • @Link
      • @Lint Errors
      • @Recent Changes
      • @Cursor Rules
      • @Notepads
      • @Summarized Composers
      • #Files
      • /command
  • 账户
    • 套餐与用量
    • 数据看板
    • 账单管理
    • 商业版
      • 快速入门
      • 成员与角色管理
      • 数据分析
      • 单点登录(SSO)
  • 设置
    • 模型管理
    • 自定义 API 密钥
    • 早期体验计划
  • 故障排除
    • 常见问题
    • 故障排除指南
    • 获取请求 ID
  1. 上下文管理

上下文协议 (Model Context Protocol)

了解如何在 Cursor 中添加和使用自定义 MCP 工具

什么是 MCP?#

模型上下文协议 (MCP, Model Context Protocol) 是一种开放协议,它规范了应用程序如何向 LLM 提供上下文和工具。可以将 MCP 视为 Cursor 的插件系统 —— 它允许你通过标准化的接口将 Agent 连接到各种数据源和工具,从而扩展 Agent 的能力。
了解更多关于 MCP 的信息
访问官方 MCP 文档以深入了解该协议

用途#

MCP 允许你将 Cursor 连接到外部系统和数据源。这意味着你可以将 Cursor 与你现有的工具和基础设施集成,而无需在代码本身之外告诉 Cursor 你的项目的结构。
MCP 服务器可以用任何语言编写,只要能打印到 stdout 或提供 HTTP 端点即可。这种灵活性允许你使用你喜欢的编程语言和技术栈非常快速地实现 MCP 服务器。

示例#

数据库#
允许 Cursor 直接查询你的数据库,而不是手动输入模式或自己操作数据。
Notion#
从 Notion 中读取数据,以指导 Cursor 实现某个功能
GitHub#
让 Cursor 创建 PR、创建分支、查找代码等
内存#
允许 Cursor 在你工作时记住和回忆信息
Stripe#
允许 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 格式,结构如下:
CLI Server - Node.js
// 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 工作区中都可用。

在 Agent 中使用 MCP 工具#

Composer Agent 将自动使用 MCP 设置页面上的“可用工具 (Available Tools)”下列出的任何 MCP 工具,如果它确定这些工具是相关的。要故意提示工具的使用,只需告诉 Agent 使用该工具,通过名称或描述来指代它。

工具批准#

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

Yolo 模式#

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

工具响应#

当使用工具时,Cursor 将在聊天中显示响应。此图显示了来自示例工具的响应,以及工具调用参数和工具调用响应的展开视图。
img

局限性#

MCP 是一种非常新的协议,并且仍在积极开发中。有一些已知的注意事项需要注意:
上一页
忽略文件配置
下一页
Overview
Built with