使用光标 MCP - Claude 桌面集成

一个 Model Context Protocol (MCP) 实现，使 Claude AI 和桌面应用程序之间实现无缝集成，通过 Cursor IDE。此工具作为桥梁，将 Claude 的能力与桌面软件结合，提升 AI 驱动的开发工作流程。

快速开始（Windows）

1. 先决条件

   • Node.js v18 或更高版本 Node.js
   • Cursor IDE
   • Windows 10 或更高版本

2. 安装

   # 全局安装
   npm install -g mcp-cursor
   
   # 或者本地安装
   git clone https://github.com/yourusername/cursor-mcp.git
   cd cursor-mcp
   npm install
   

3. 配置

   • 在项目根目录创建一个 .env 文件：

     # Windows 路径示例
     DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
     

4. 添加到 Claude 的 MCP 配置中 将以下内容添加到您的 Claude 配置中：

   {
     "name": "cursor",
     "type": "mcp",
     "config": {
       "server": "https://glama.ai/mcp/servers/4fg1gxbcex",
       "capabilities": ["cursor_control", "window_management"]
     }
   }
   

5. 启动服务器

   # 如果全局安装
   mcp-cursor
   
   # 如果本地安装
   npm start
   

功能

• 实时 AI 辅助开发工作流程
• 上下文感知的代码建议和完成
• 与 Cursor IDE 的无缝集成
• Windows 自动化以提升生产力

详细设置

本地开发环境搭建

1. 克隆并安装：

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

2. 创建环境配置：

   cp .env.example .env
   

   编辑 .env 并设置您的工作区路径：

   DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
   

3. 构建并运行：

   # 开发模式带热重载
   npm run dev
   
   # 生产模式
   npm run build
   npm start
   

故障排除

1. 窗口检测问题

   • 确保 Cursor IDE 正在运行
   • 尝试重新启动 MCP 服务器
   • 检查工作区路径是否正确

2. 权限问题

   • 以管理员身份运行终端进行初始设置
   • 确保工作区目录有正确的文件权限

3. Node 版本问题

   • 使用 nvm 切换到 Node.js v18 或更高版本：

     nvm install 18
     nvm use 18
     

项目结构

cursor-mcp/
├── src/           # 源代码
│   ├── services/  # 核心服务
│   ├── handlers/  # 事件处理程序
│   └── types/     # TypeScript 定义
├── build/         # 编译后的 JavaScript
└── .env          # 环境配置

脚本

• npm run build - 编译 TypeScript
• npm start - 运行生产服务器
• npm run dev - 启动带有热重载的开发服务器

贡献

1. 叉仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开一个 Pull Request

许可证

MIT License - 有关详细信息，请参阅 LICENSE 文件。

支持

寻求帮助：

• 在 GitHub 仓库中打开一个问题
• 加入我们的 Discord 社区
• 检查 FAQ