将 MCP 与 Cursor 集成在一起 | 综合指南

admin 技术文档 2025-04-11 15

摘要:作者: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/directory

PostgreSQL 服务器

1. 安装服务器:

npm install -g @modelcontextprotocol/server-postgresRetry

2. 运行服务器:

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

相关推荐

评论列表
关闭

用微信“扫一扫”