光标MCP（模型上下文协议）
Cursor MCP是Claude桌面应用程序和Cursor编辑器之间的桥梁，实现了无缝的AI自动化和多实例管理。它是更广泛的模型上下文协议（MCP）生态系统的一部分，允许Cursor通过标准化接口与各种AI模型和服务进行交互。
概述
🤖 人工智能集成
- 与Claude的桌面应用程序直接集成
- 能够利用其他兼容MCP的AI服务
- AI和编辑器之间的实时上下文共享
- 人工智能驱动的自动化和代码生成
🔌 MCP协议支持
- 与AI模型的标准化沟通
- 用于附加MCP的可扩展插件系统
- 上下文感知命令执行
- 基于安全令牌的身份验证
🖥️ 跨平台窗口管理
- 跨操作系统无缝管理游标编辑器窗口
- 以编程方式聚焦、最小化、还原和排列窗口
- 跟踪窗口状态变化和位置
- 同时处理多个游标实例
⌨️ 输入自动化
- 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)配置
该工具可以通过环境变量或配置文件在以下位置进行配置：
- 窗户：
%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"
}
}安装
视窗
# 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.ps1macOS
# 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.shLinux
# 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服务器之间的中间件层：
- 光标集成:
- 监视Cursor的文件系统事件 - 捕获编辑器状态和上下文 - 将响应注入编辑器 - 管理窗口和流程自动化
- MCP协议转换:
- 将Cursor的内部事件转换为MCP协议消息 - 将MCP响应转换为与游标兼容的操作 - 维护会话状态和上下文 - 处理身份验证和安全
- 服务器通信:
- 连接到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. Cursor Event (File Change)
// When user types in Cursor:
function calculateTotal(items) {
// Calculate the total price of items| {
return total + (item.price * item.quantity);
}, 0);`
// 5. Cursor Integration
// Bridge injects the code at cursor position- 代码重构:
// 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- 多文件上下文:
// 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集成方法
- 文件系统监控:
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)
})- 窗口集成:
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)
})- 上下文管理:
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开发
- libpng++-dev
- 编译工具
发展
设置
# 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许可证获得许可-请参阅 许可证 文件以获取详细信息。