摘要:作者:UshioShizuku编译:小兰引言模型上下文协议 (Model Context Protocol, MCP) 是由 Anthropic 开发的一个开放标准,它标准化了应用程序如何向大型语言模型 (LLM) 提供上下文和工具。...
作者:UshioShizuku
编译:小兰
引言
模型上下文协议 (Model Context Protocol, MCP) 是由 Anthropic 开发的一个开放标准,它标准化了应用程序如何向大型语言模型 (LLM) 提供上下文和工具。
本指南将引导您完成将 MCP 与 Cursor(一个强大的 AI 增强代码编辑器)集成的过程,让您能够通过标准化的接口将 Cursor 连接到各种数据源和工具,从而扩展其功能。
MCP 是什么?
MCP 充当您的代码与其所需数据之间的桥梁,确保与各种数据源的无缝集成,包括:
API云数据库本地文件开发环境业务工具内容存储库主要优势 (Key Benefits):
上下文管理 (Context Management):确保您的 AI 模型能够访问所需的上下文即插即用集成 (Plug-and-Play Integration):过程简单直接,仅需最少的配置增强模型性能 (Enhanced Model Performance):提高模型的上下文理解能力灵活性 (Flexibility):适应您的特定需求为什么将 MCP 与 Cursor 集成?
Cursor 已经提供了强大的 AI 功能用于编码辅助,但通过 MCP 集成,您可以:
1. 连接到外部系统和数据源2. 与现有工具和基础设施集成3. 允许 Cursor 直接查询数据库4. 实现从各种知识库读取数据5. 创建特定于您工作流程的自定义工具架构概览
MCP 架构包括:
MCP 主机 (MCP Hosts):像 Cursor 这样希望通过 MCP 访问数据的程序MCP 客户端 (MCP Clients):维护与服务器连接的协议客户端MCP 服务器 (MCP Servers):通过标准化协议公开特定功能的轻量级程序本地数据源 (Local Data Sources):您计算机的文件、数据库和服务远程服务 (Remote Services):可通过互联网访问的外部系统在 Cursor 中设置 MCP
先决条件
Cursor 版本 0.45.7 或更高版本已安装 Node.js(用于运行基于 JavaScript 的 MCP 服务器)对终端/命令行有基本了解步骤 1:在 Cursor 设置中启用 MCP
1. 打开 Cursor2. 导航至 设置 (Settings) > 功能 (Features)3. 找到并启用 “MCP 服务器 (MCP Servers)” 选项步骤 2:配置 MCP 服务器
可以通过两种方式添加 MCP 服务器配置:
方法 1:配置文件(推荐)
在以下位置之一创建或编辑 MCP 配置文件:
macOS: ~/Library/Application Support/Cursor/mcp-servers.jsonWindows: %APPDATA%\Cursor\mcp-servers.jsonLinux: ~/.config/Cursor/mcp-servers.json示例配置:
{ "servers": [ { "name": "filesystem", "type": "command", "command": "npx -y @modelcontextprotocol/server-filesystem /path/to/directory" }, { "name": "postgres", "type": "sse", "url": "http://localhost:3030" } ] }方法 2:UI 配置
导航至 设置 (Settings) > 功能 (Features) > MCP 服务器 (MCP Servers)点击 “添加 MCP 服务器 (Add MCP Server)”填写必填字段:名称 (Name)类型 (Type) (command 或 sse)命令 (Command) 或 URL步骤 3:安装并运行 MCP 服务器
有几个预构建的 MCP 服务器可用。以下是一些常见示例:
文件系统服务器
npx -y @modelcontextprotocol/server-filesystem /path/to/directoryPostgreSQL 服务器
1. 安装服务器:
npm install -g @modelcontextprotocol/server-postgresRetry2. 运行服务器:
mcp-postgres --connection-string "postgresql://username:password@localhost:5432/database"SQLite 服务器
npx -y @modelcontextprotocol/server-sqlite /path/to/database.sqliteRetry社区和第三方资源
MCP Index[1]:一个全面的 MCP 服务器、工具和资源目录GitHub Community Servers[2]:社区开发的 MCP 服务器实现在 Cursor 中使用 MCP 工具
配置完成后,您可以在 Cursor 的 Agent 中使用 MCP 工具:
1. 打开 Agent (Cmd+K 或 Ctrl+K)2. 输入可能需要外部数据的查询3. Cursor 现在将能够使用 MCP 工具访问外部数据工具审批
默认情况下,Cursor 在执行 MCP 工具之前会请求您的批准。您可以配置此行为:
导航至 设置 (Settings) > 功能 (Features) > MCP 服务器 (MCP Servers)配置 “工具审批 (Tool Approval)” 设置:总是询问 (Always Ask):每次执行工具前提示批准(默认)始终执行 (Yolo Mode):执行工具时不询问批准用法示例
以下是您可以在 Cursor 中使用 MCP 实现的一些示例:
数据库集成
// 在 Cursor Agent 中 查询上个月注册的所有用户,并将结果格式化为表格Cursor 将会:
1. 使用 PostgreSQL MCP 服务器连接到您的数据库2. 生成并执行相应的 SQL 查询3. 格式化并显示结果文件系统集成
// 在 Cursor Agent 中 在我的项目中查找所有 TODO 注释,并按优先级组织它们Cursor 将会:
1. 使用文件系统 MCP 服务器扫描您的项目2. 识别 TODO 注释3. 按优先级分析和组织它们创建自定义 MCP 服务器
您可以创建自己的 MCP 服务器来进一步扩展 Cursor 的功能:
1. 选择一种编程语言(MCP 服务器可以用任何语言编写)2. 实现 MCP 协议规范3. 将所需功能公开为工具或资源有关创建自定义 MCP 服务器的详细说明,请参阅 官方 MCP 文档[3]。
限制与注意事项
工具数量 (Tool Quantity):Cursor 目前支持来自 MCP 服务器的最多 40 个工具。远程开发 (Remote Development):通过 SSH 或其他远程开发环境访问 Cursor 时,MCP 服务器可能无法正常工作。MCP 资源 (MCP Resources):虽然 MCP 同时提供工具和资源,但 Cursor 目前仅支持工具。资源支持计划在未来版本中推出。故障排除
常见问题
MCP 服务器无法连接 (MCP Server Not Connecting):确认服务器正在运行检查 URL 或命令是否正确确保网络访问未被防火墙阻止2. 权限错误 (Permission Errors):
确保 MCP 服务器具有访问其所需资源的适当权限3. 性能问题 (Performance Issues):
考虑限制 MCP 服务器有权访问的数据范围使用更具体的查询以减少处理时间结论
将 MCP 与 Cursor 集成,这创建了一个强大的开发环境,它将 AI 辅助编码与对外部数据源和工具的无缝访问相结合。
通过遵循本指南,您已经学会了如何设置和配置 MCP 服务器,在 Cursor 中使用它们,以及解决常见问题。
如需更多信息,请参阅官方文档:
模型上下文协议文档 (Model Context Protocol Documentation)[4]Cursor 关于 MCP 的文档 (Cursor Documentation on MCP)[5]引用链接
[1] MCP Index: https://mcpindex.net/
[2] GitHub Community Servers: https://github.com/modelcontextprotocol/servers
[3] 官方 MCP 文档: https://modelcontextprotocol.io/docs/concepts/architecture
[4] 模型上下文协议文档 (Model Context Protocol Documentation): https://modelcontextprotocol.io/
[5] Cursor 关于 MCP 的文档 (Cursor Documentation on MCP): https://docs.cursor.com/context/model-context-protocol