Cursor MCP - Claude Desktop Integration

项目简介

Cursor MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在桥接 Claude AI 和 Cursor IDE 桌面应用。通过此工具，Claude 等 LLM 客户端可以与 Cursor IDE 进行无缝集成，实现 AI 增强的开发工作流程。

主要功能点

Cursor IDE 控制: 允许 LLM 客户端启动和管理 Cursor IDE 实例。
命令执行: 支持 LLM 客户端在 Cursor IDE 中执行预定义的命令，例如打开 Cline 标签页、打开命令面板等。
Windows 自动化: 利用 Windows 自动化技术，模拟键盘输入和窗口操作，实现对 Cursor IDE 的程序化控制。
工具集成: 提供 'open_cursor', 'cursor_command', 'open_cline_tab' 等工具，扩展 LLM 的能力，使其可以与 Cursor IDE 交互。

安装步骤

方法一：通过 Smithery 安装 (推荐)

确保已安装 Smithery CLI。

运行以下命令，自动安装 Cursor MCP 工具并配置 Claude 客户端：

npx -y @smithery/cli install cursor-mcp-tool --client claude

方法二：手动安装

前提条件
- 确保已安装 Node.js v18 或更高版本。
- 确保已安装 Cursor IDE。
- 操作系统为 Windows 10 或更高版本。

安装

全局安装 (推荐，方便运行)

npm install -g mcp-cursor

本地安装 (在项目目录中运行)

git clone https://github.com/Buga-luga/cursor-mcp.git
cd cursor-mcp
npm install

配置环境变量
- 在项目根目录下创建 '.env' 文件（如果使用本地安装，全局安装则不需要手动创建）。
- 在 '.env' 文件中设置 'DEFAULT_WORKSPACE_PATH' 环境变量，指定 Cursor 工作区路径（Windows 路径示例）：
```
DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
```

服务器配置 (MCP 客户端配置)

MCP 客户端（例如 Claude）需要配置以下 JSON 对象以连接到 Cursor MCP 服务器。请将以下配置添加到 Claude 的 MCP 配置中：

{
  "name": "cursor",
  "type": "mcp",
  "config": {
    "server": "http://localhost:3000",  // 或者您部署服务器的地址，本地运行时可以使用 localhost
    "command": "mcp-cursor",             // 启动服务器的命令 (全局安装时)
    "args": [],                          // 启动参数，默认为空
    // 如果本地安装，command 和 args 配置如下
    // "command": "node",
    // "args": ["build/index.js"],
    "capabilities": ["cursor_control", "window_management"] // 声明服务器提供的能力
  }
}

参数说明:

'server': MCP 服务器的地址。本地运行时，如果直接运行 'mcp-cursor' 命令，客户端可以配置为 'http://localhost:3000' 或 'https://glama.ai/mcp/servers/4fg1gxbcex' (Smithery 提供的在线服务地址)。
'command': 启动 MCP 服务器的命令。
- 如果您 全局安装 了 'mcp-cursor'，可以直接使用 'mcp-cursor' 命令。
- 如果您是 本地安装，并且希望直接运行 'build/index.js'，则 'command' 应设置为 'node'，'args' 设置为 '["build/index.js"]'。
'args': 启动服务器命令的参数，根据实际情况配置，这里默认不需要额外参数，保持为空数组 '[]' 即可。
'capabilities': 声明客户端期望服务器提供的能力，'["cursor_control", "window_management"]' 表明客户端希望使用 Cursor 控制和窗口管理功能。

注意: 'server' 字段在客户端配置中通常用于指定一个 HTTP 端点，但对于 'stdio' 传输方式的 MCP 服务器（如 Cursor MCP），客户端与服务器通过标准输入输出流直接通信，'server' 字段可能被客户端忽略或用于其他用途 (例如 Smithery 平台可能使用此字段来标识服务器)。 重要的是 'command' 和 'args' 配置，它们指示客户端如何启动和连接到本地运行的 MCP 服务器进程。

基本使用方法

启动服务器
- 全局安装时: 在命令行中直接运行 'mcp-cursor' 命令启动服务器。
```
mcp-cursor
```
- 本地安装时: 在项目根目录下运行 'npm start' 命令启动服务器。
```
npm start
```
配置 Claude 客户端: 按照 "服务器配置" 章节的说明，将 JSON 配置添加到 Claude 客户端的 MCP 设置中。
在 Claude 中使用: 现在 Claude 应该能够通过 Cursor MCP 服务器与 Cursor IDE 进行交互了。您可以指示 Claude 使用 'cursor' 工具来打开 Cursor IDE、执行命令或操作 Cline 标签页。例如，您可以对 Claude 说：
- "打开 Cursor IDE"
- "在 Cursor IDE 中打开一个新的 Cline 标签页"
- "在 Cursor IDE 中执行 '打开设置' 命令"

请参考仓库的 README 和代码文档获取更详细的使用方法和工具调用示例。

关键词