多

多平台Cursor连接器

@johnneerdael/multiplatform-cursor-mcp
0 Stars 341 次浏览 johnneerdael 更新于 2026-08-23

充当 Claude 桌面应用程序与 Cursor 编辑器之间的桥梁，实现跨平台的无缝人工智能驱动自动化和多实例管理，具备标准化通信和安全的基于令牌的身份验证。

开发者工具
该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

Cursor MCP (模型上下文协议)

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

概览

🤖 AI 集成

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

🔌 MCP 协议支持

  • 与 AI 模型的标准通信
  • 可扩展的插件系统以支持额外的 MCP
  • 上下文感知的命令执行
  • 基于安全令牌的身份验证

🖥️ 跨平台窗口管理

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

⌨️ 输入自动化

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

🔄 进程管理

  • AI 编排的实例管理
  • 智能工作区组织
  • 自动上下文保存
  • 智能会话恢复

MCP 集成

Claude 桌面集成

import { ClaudeMCP } from 'cursor-mcp/claude'

// Connect to Claude's desktop app
const claude = await ClaudeMCP.connect()

// Execute AI-powered operations
await claude.generateCode({
    prompt: 'Create a React component',
    context: currentFileContent,
    language: 'typescript'
})

// Get AI suggestions
const suggestions = await claude.getSuggestions({
    code: selectedText,
    type: 'refactor'
})

使用多个 MCP

import { MCPRegistry } from 'cursor-mcp/registry'

// Register available MCPs
MCPRegistry.register('claude', ClaudeMCP)
MCPRegistry.register('github-copilot', CopilotMCP)

// Use different AI services
const claude = await MCPRegistry.get('claude')
const copilot = await MCPRegistry.get('github-copilot')

// Compare suggestions
const claudeSuggestions = await claude.getSuggestions(context)
const copilotSuggestions = await copilot.getSuggestions(context)

自定义 MCP 集成

import { BaseMCP, MCPProvider } from 'cursor-mcp/core'

class CustomMCP extends BaseMCP implements MCPProvider {
    async connect() {
        // Custom connection logic
    }

    async generateSuggestions(context: CodeContext) {
        // Custom AI integration
    }
}

// Register custom MCP
MCPRegistry.register('custom-ai', CustomMCP)

配置

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

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

示例配置：

{
    "mcp": {
        "claude": {
            "enabled": true,
            "apiKey": "${CLAUDE_API_KEY}",
            "contextWindow": 100000
        },
        "providers": {
            "github-copilot": {
                "enabled": true,
                "auth": "${GITHUB_TOKEN}"
            }
        }
    },
    "autoStart": true,
    "maxInstances": 4,
    "windowArrangement": "grid",
    "logging": {
        "level": "info",
        "file": "cursor-mcp.log"
    }
}

安装

Windows

# Run as Administrator
Invoke-WebRequest -Uri "https://github.com/your-org/cursor-mcp/releases/latest/download/cursor-mcp-windows.zip" -OutFile "cursor-mcp.zip"
Expand-Archive -Path "cursor-mcp.zip" -DestinationPath "."
.\windows.ps1

macOS

# Run with sudo
curl -L "https://github.com/your-org/cursor-mcp/releases/latest/download/cursor-mcp-macos.zip" -o "cursor-mcp.zip"
unzip cursor-mcp.zip
sudo ./macos.sh

Linux

# Run with sudo
curl -L "https://github.com/your-org/cursor-mcp/releases/latest/download/cursor-mcp-linux.zip" -o "cursor-mcp.zip"
unzip cursor-mcp.zip
sudo ./linux.sh

使用方法

基本使用

import { CursorInstanceManager } from 'cursor-mcp'

// Get the instance manager
const manager = CursorInstanceManager.getInstance()

// Start a new Cursor instance
await manager.startNewInstance()

// Get all running instances
const instances = await manager.getRunningInstances()

// Focus a specific instance
await manager.focusInstance(instances[0])

// Close all instances
await manager.closeAllInstances()

窗口管理

import { WindowManager } from 'cursor-mcp'

const windowManager = WindowManager.getInstance()

// Find all Cursor windows
const windows = await windowManager.findCursorWindows()

// Focus a window
await windowManager.focusWindow(windows[0])

// Arrange windows side by side
await windowManager.arrangeWindows(windows, 'sideBySide')

// Minimize all windows
for (const window of windows) {
    await windowManager.minimizeWindow(window)
}

输入自动化

import { InputAutomationService } from 'cursor-mcp'

const inputService = InputAutomationService.getInstance()

// Type text
await inputService.typeText('Hello, World!')

// Send keyboard shortcuts
if (process.platform === 'darwin') {
    await inputService.sendKeys(['command', 'c'])
} else {
    await inputService.sendKeys(['control', 'c'])
}

// Mouse operations
await inputService.moveMouse(100, 100)
await inputService.mouseClick('left')
await inputService.mouseDrag(100, 100, 200, 200)

工作原理

桥接架构

该工具作为 Cursor 和 MCP 服务器之间的中间层：

  1. Cursor 集成：

    • 监视 Cursor 的文件系统事件
    • 捕获编辑器状态和上下文
    • 将响应注入回编辑器
    • 管理窗口和进程自动化

  2. MCP 协议转换：

    • 将 Cursor 的内部事件转换为 MCP 协议消息
    • 将 MCP 响应转换为 Cursor 兼容的操作
    • 维护会话状态和上下文
    • 处理身份验证和安全性

  3. 服务器通信：

    • 连接到 Claude 的桌面应用程序 MCP 服务器
    • 将请求路由到适当的 AI 提供者
    • 管理与多个 MCP 的并发连接
    • 处理回退和错误恢复
graph LR
    A[Cursor Editor] <--> B[Cursor MCP Bridge]
    B <--> C[Claude Desktop MCP]
    B <--> D[GitHub Copilot MCP]
    B <--> E[Custom AI MCPs]

示例工作流程

  1. 代码补全请求:

    // 1. 光标事件（文件更改）
// 当用户在光标处输入时：
function calculateTotal(items) {
  // 计算商品总价|  <-- 光标位置

// 2. 桥接转换
const event = {
  type: 'completion_request',
  context: {
    file: 'shopping-cart.ts',
    line: 2,
    prefix: '// 计算商品总价',
    language: 'typescript',
    cursor_position: 43
  }
}

// 3. MCP 协议消息
await mcpServer.call('generate_completion', {
  prompt: event.context,
  max_tokens: 150,
  temperature: 0.7
})

// 4. 响应转换
// 桥接将 MCP 响应转换为：
const response = `return items.reduce((total, item) => {
  return total + (item.price * item.quantity);
}, 0);`

// 5. 光标集成
// 桥接在光标位置插入代码

  2. 代码重构:

    // 1. 光标事件（命令）
// 用户选择代码并触发重构命令
const oldCode = `
  if (user.age >= 18) {
    if (user.hasLicense) {
      if (car.isAvailable) {
        rentCar(user, car);
      }
    }
  }
`

// 2. 桥接转换
const event = {
  type: 'refactor_request',
  context: {
    selection: oldCode,
    command: 'simplify_nesting'
  }
}

// 3. MCP 协议消息
await mcpServer.call('refactor_code', {
  code: event.context.selection,
  style: 'simplified',
  maintain_logic: true
})

// 4. 响应转换
const response = `
  const canRentCar = user.age >= 18 
    && user.hasLicense 
    && car.isAvailable;

  if (canRentCar) {
    rentCar(user, car);
  }
`

// 5. 光标集成
// 桥接替换选中的代码

  3. 多文件上下文:

    // 1. 光标事件（文件依赖）
// 当用户请求帮助某个组件时

// 2. 桥接转换
const event = {
  type: 'context_request',
  files: {
    'UserProfile.tsx': '...',
    'types.ts': '...',
    'api.ts': '...'
  },
  focus_file: 'UserProfile.tsx'
}

// 3. MCP 协议消息
await mcpServer.call('analyze_context', {
  files: event.files,
  primary_file: event.focus_file,
  analysis_type: 'component_dependencies'
})

// 4. 响应处理
// 桥接维护跨请求的上下文

集成方法

  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()

// 注入AI响应
await window.injectCode({
  position: cursorPosition,
  code: mcpResponse.code,
  animate: true  // 平滑的打字动画
})

// 处理用户交互
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()

// 跟踪文件依赖
await context.addFile('component.tsx')
await context.trackDependencies()

// 维护对话历史
context.addMessage({
  role: 'user',
  content: '重构这个组件'
})

// 发送到MCP服务器
const response = await mcpServer.send({
  type: 'refactor',
  context: context.getFullContext()
})

安全性

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

系统要求

Windows

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

macOS

  • macOS 10.15 (Catalina) 或更高版本
  • Node.js 18 或更高版本
  • Xcode 命令行工具
  • 终端访问权限

Linux

  • X11 显示服务器
  • Node.js 18 或更高版本
  • xdotool
  • libxtst-dev
  • libpng++-dev
  • build-essential

开发

设置

# Clone the repository
git clone https://github.com/your-org/cursor-mcp.git
cd cursor-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

运行测试

# Run all tests
npm test

# Run specific test suite
npm test -- window-management

# Run with coverage
npm run test:coverage

贡献

我们欢迎贡献！请参阅我们的贡献指南以获取详细信息。

许可证

本项目根据MIT许可证发布 - 详情请参见LICENSE文件。

支持

致谢

查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。