Cursor MCP 集成指南

安装与配置

在开始使用 Cursor 的 MCP 功能之前，您需要先安装和配置 Cursor 编辑器。以下是安装和配置 Cursor 的步骤：

1. 访问 Cursor 官网 下载最新版本的 Cursor 编辑器
2. 安装 Cursor 编辑器，按照安装向导完成安装过程
3. 启动 Cursor 编辑器，并使用您的账号登录
4. 完成初始设置，包括选择主题、配置编辑器选项等

启用MCP功能

安装 Cursor 后，您需要启用 MCP 功能。以下是启用 MCP 功能的步骤：

1. 打开 Cursor 编辑器
2. 点击左下角的设置图标，或使用快捷键 Ctrl+,（Windows/Linux）或 Cmd+,（macOS）打开设置
3. 在设置页面中，选择 Features 选项卡
4. 找到 MCP 部分，确保 MCP 功能已启用

Cursor MCP 设置界面

Cursor MCP 设置界面（示意图）

启用 MCP 功能后，您可以开始添加和配置 MCP 服务器，以便 Cursor 的 AI 助手能够使用各种 MCP 工具。

Stdio传输方式

Stdio（标准输入输出）传输方式是最常用的传输方式，适用于本地运行的 MCP 服务器。配置 Stdio 传输方式时，您需要提供一个命令，Cursor 将执行该命令并通过标准输入输出与 MCP 服务器通信。

# 使用 .NET MCP 服务器的示例命令
dotnet run --project /path/to/your/mcp-server/project

# 使用 Node.js MCP 服务器的示例命令
npx -y @smithery/cli@latest run @mzxrai/mcp-webresearch --config "{}"

# 使用 Python MCP 服务器的示例命令
python /path/to/your/mcp_server.py

SSE传输方式

SSE（Server-Sent Events）传输方式适用于远程 MCP 服务器，它使用 HTTP 长连接实现服务器向客户端的单向通信。配置 SSE 传输方式时，您需要提供服务器的 URL。

# SSE 传输方式的 URL 示例
https://example.com/mcp/sse

# 带有认证令牌的 URL 示例
https://example.com/mcp/sse?token=your_auth_token

WebSocket传输方式

WebSocket 传输方式也适用于远程 MCP 服务器，它提供了全双工通信，支持客户端和服务器之间的双向实时通信。配置 WebSocket 传输方式时，您需要提供服务器的 WebSocket URL。

# WebSocket 传输方式的 URL 示例
ws://example.com/mcp/ws

# 安全 WebSocket 的 URL 示例
wss://example.com/mcp/ws

# 带有认证令牌的 URL 示例
wss://example.com/mcp/ws?token=your_auth_token

工具发现

当您添加 MCP 服务器后，Cursor 会自动发现该服务器提供的工具。您可以在 MCP 设置页面中查看已发现的工具列表：

1. 打开 Cursor 设置
2. 选择 Features > MCP
3. 在服务器列表中，找到您添加的服务器
4. 点击服务器名称旁边的 View Tools 按钮
5. 在弹出的对话框中，您可以看到该服务器提供的所有工具

工具调用

在 Cursor 中，您可以通过 AI 助手调用 MCP 工具。以下是调用 MCP 工具的方法：

1. 打开 Cursor 的 AI 助手（Composer）
2. 输入您的请求，描述您想要完成的任务
3. AI 助手会自动选择合适的 MCP 工具来完成任务
4. 如果需要，您可以明确指示 AI 助手使用特定的工具

您也可以明确指示 AI 助手使用特定的工具：

结果处理

当 MCP 工具执行完成后，AI 助手会处理工具返回的结果，并根据结果生成响应。以下是结果处理的一些常见方式：

• 文本结果：AI 助手会直接显示文本结果，或者根据结果生成摘要和解释
• JSON 结果：AI 助手会解析 JSON 数据，并以易于理解的方式呈现
• 图像结果：AI 助手会显示图像，并可能提供图像的描述和分析
• 错误结果：AI 助手会解释错误原因，并可能提供解决方案或替代方案

自定义工具

除了使用现有的 MCP 工具外，您还可以创建自定义工具来满足特定需求。以下是创建自定义 MCP 工具的步骤：

1. 创建一个新的 .NET 项目，用于实现 MCP 服务器
2. 安装 ModelContextProtocol NuGet 包
3. 实现自定义工具类和方法
4. 配置 MCP 服务器，注册自定义工具
5. 启动 MCP 服务器
6. 在 Cursor 中添加自定义 MCP 服务器

以下是一个自定义工具的示例：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using ModelContextProtocol.Server;
using System.ComponentModel;

namespace CustomMcpTools
{
    public class Program
    {
        public static async Task Main(string[] args)
        {
            var builder = Host.CreateApplicationBuilder(args);
            
            // 配置 MCP 服务器
            builder.Services
                .AddMcpServer()
                .WithStdioServerTransport()
                .WithToolsFromAssembly();
                
            await builder.Build().RunAsync();
        }
    }
    
    [McpServerToolType]
    public static class CustomTools
    {
        [McpServerTool, Description("Converts text to uppercase.")]
        public static string ToUpperCase(
            [Description("Text to convert to uppercase")] string text)
        {
            return text.ToUpper();
        }
        
        [McpServerTool, Description("Converts text to lowercase.")]
        public static string ToLowerCase(
            [Description("Text to convert to lowercase")] string text)
        {
            return text.ToLower();
        }
        
        [McpServerTool, Description("Counts words in text.")]
        public static int CountWords(
            [Description("Text to count words in")] string text)
        {
            return text.Split(new[] { ' ', '\t', '\n', '\r' }, StringSplitOptions.RemoveEmptyEntries).Length;
        }
    }
}

创建自定义工具后，您可以在 Cursor 中添加自定义 MCP 服务器，并使用自定义工具。

工具权限

在 Cursor 中，您可以控制 AI 助手对 MCP 工具的访问权限。以下是配置工具权限的步骤：

1. 打开 Cursor 设置
2. 选择 Features > MCP
3. 在服务器列表中，找到您要配置的服务器
4. 点击服务器名称旁边的 View Tools 按钮
5. 在工具列表中，您可以看到每个工具的权限设置
6. 点击工具旁边的权限图标，选择适当的权限级别

通过配置工具权限，您可以控制 AI 助手对敏感操作的访问，提高系统的安全性。

工具链接

工具链接是指 AI 助手连续使用多个工具来完成复杂任务的能力。在 Cursor 中，AI 助手可以自动进行工具链接，无需用户干预。

工具链接使 AI 助手能够执行更复杂的任务，提高工作效率。您可以通过自然语言描述任务，AI 助手会自动选择合适的工具并按顺序调用它们。