Cursor MCP Server

游标 MCP（模型上下文协议）

Cursor MCP 是 Claude 桌面应用程序和 Cursor 编辑器之间的桥梁，可实现无缝的 AI 自动化和多实例管理。它是更广泛的模型上下文协议 (MCP) 生态系统的一部分，允许 Cursor 通过标准化接口与各种 AI 模型和服务进行交互。

概述

🤖 AI 集成

• 与 Claude 的桌面应用程序直接集成
• 能够利用其他与 MCP 兼容的 AI 服务
• AI 与编辑之间的实时上下文共享
• 人工智能驱动的自动化和代码生成

🔌 MCP 协议支持

• 与AI模型的标准化沟通
• 可扩展插件系统，用于附加 MCP
• 上下文感知命令执行
• 基于令牌的安全身份验证

🖥️ 跨平台窗口管理

• 无缝管理跨操作系统的 Cursor 编辑器窗口
• 通过编程聚焦、最小化、恢复和排列窗口
• 跟踪窗口状态变化和位置
• 同时处理多个 Cursor 实例

⌨️ 输入自动化

• AI 驱动的键盘输入支持：
  • 代码生成和插入
  • 重构操作
  • 上下文感知补全
  • 多光标编辑
• 智能鼠标自动化包括：
  • 智能选择
  • 上下文菜单操作
  • 人工智能导航

🔄 流程管理

• AI 协调的实例管理
• 智能工作空间组织
• 自动上下文保存
• 智能会话恢复

MCP 集成

Claude 桌面集成

使用多个 MCP

自定义 MCP 集成

配置

该工具可以通过环境变量或配置文件进行配置：

• Windows： %LOCALAPPDATA%\cursor-mcp\config\config.json
• macOS： ~/Library/Application Support/cursor-mcp/config/config.json
• Linux： ~/.config/cursor-mcp/config.json

示例配置：

安装

视窗

macOS

Linux

用法

基本用法

窗口管理

输入自动化

工作原理

桥梁建筑

此工具充当 Cursor 和 MCP 服务器之间的中间件层：

1. 光标集成：
   • 监视 Cursor 的文件系统事件
   • 捕获编辑器状态和上下文
   • 将响应注入编辑器
   • 管理窗口和流程自动化
2. MCP 协议转换：
   • 将 Cursor 的内部事件转换为 MCP 协议消息
   • 将 MCP 响应转换为与 Cursor 兼容的操作
   • 维护会话状态和上下文
   • 处理身份验证和安全
3. 服务器通信：
   • 连接到 Claude 的桌面应用程序 MCP 服务器
   • 将请求路由到适当的 AI 提供商
   • 管理与多个 MCP 的并发连接
   • 处理回退和错误恢复

示例工作流程

1. 代码完成请求：
   // 1. Cursor Event (File Change) // When user types in Cursor: function calculateTotal(items) { // Calculate the total price of items| <-- cursor position // 2. Bridge Translation const event = { type: 'completion_request', context: { file: 'shopping-cart.ts', line: 2, prefix: '// Calculate the total price of items', language: 'typescript', cursor_position: 43 } } // 3. MCP Protocol Message await mcpServer.call('generate_completion', { prompt: event.context, max_tokens: 150, temperature: 0.7 }) // 4. Response Translation // Bridge converts MCP response: const response = `return items.reduce((total, item) => { return total + (item.price * item.quantity); }, 0);` // 5. Cursor Integration // Bridge injects the code at cursor position
2. 代码重构：
   // 1. Cursor Event (Command) // User selects code and triggers refactor command const oldCode = ` if (user.age >= 18) { if (user.hasLicense) { if (car.isAvailable) { rentCar(user, car); } } } ` // 2. Bridge Translation const event = { type: 'refactor_request', context: { selection: oldCode, command: 'simplify_nesting' } } // 3. MCP Protocol Message await mcpServer.call('refactor_code', { code: event.context.selection, style: 'simplified', maintain_logic: true }) // 4. Response Translation const response = ` const canRentCar = user.age >= 18 && user.hasLicense && car.isAvailable; if (canRentCar) { rentCar(user, car); } ` // 5. Cursor Integration // Bridge replaces selected code
3. 多文件上下文：
   // 1. Cursor Event (File Dependencies) // When user requests help with a component // 2. Bridge Translation const event = { type: 'context_request', files: { 'UserProfile.tsx': '...', 'types.ts': '...', 'api.ts': '...' }, focus_file: 'UserProfile.tsx' } // 3. MCP Protocol Message await mcpServer.call('analyze_context', { files: event.files, primary_file: event.focus_file, analysis_type: 'component_dependencies' }) // 4. Response Processing // Bridge maintains context across requests

积分方法

1. 文件系统监控：
   import { FileSystemWatcher } from 'cursor-mcp/watcher' const watcher = new FileSystemWatcher({ paths: ['/path/to/cursor/workspace'], events: ['change', 'create', 'delete'] }) watcher.on('change', async (event) => { const mcpMessage = await bridge.translateEvent(event) await mcpServer.send(mcpMessage) })
2. 窗口集成：
   import { CursorWindow } from 'cursor-mcp/window' const window = new CursorWindow() // Inject AI responses await window.injectCode({ position: cursorPosition, code: mcpResponse.code, animate: true // Smooth typing animation }) // Handle user interactions window.onCommand('refactor', async (selection) => { const mcpMessage = await bridge.createRefactorRequest(selection) const response = await mcpServer.send(mcpMessage) await window.applyRefactoring(response) })
3. 上下文管理：
   import { ContextManager } from 'cursor-mcp/context' const context = new ContextManager() // Track file dependencies await context.addFile('component.tsx') await context.trackDependencies() // Maintain conversation history context.addMessage({ role: 'user', content: 'Refactor this component' }) // Send to MCP server const response = await mcpServer.send({ type: 'refactor', context: context.getFullContext() })

安全

• 基于令牌的安全 AI 服务身份验证
• 加密通信渠道
• 沙盒执行环境
• 细粒度的权限控制

要求

视窗

• Windows 10 或更高版本
• Node.js 18 或更高版本
• 安装的管理员权限

macOS

• macOS 10.15 (Catalina) 或更高版本
• Node.js 18 或更高版本
• Xcode 命令行工具
• 终端的辅助功能权限

Linux

• X11显示服务器
• Node.js 18 或更高版本
• xdotool
• libxtst-dev
• libpng++-dev
• 构建必需

发展

设置

运行测试

贡献

欢迎大家贡献！详情请参阅我们的贡献指南。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

支持

• 📚文档
• 🐛问题追踪器
• 💬讨论
• 🔒安全

致谢

• Cursor Editor - AI-first 代码编辑器
• Claude AI - 高级人工智能助手
• @nut-tree/nut-js - 跨平台自动化
• active-win - 窗口检测