Cursor MCP - Claude 桌面集成

一个模型上下文协议 (MCP) 实现，通过 Cursor IDE 实现 Claude AI 和桌面应用程序之间的无缝集成。此工具充当 Claude 的功能和桌面软件之间的桥梁，从而实现增强的 AI 驱动的开发工作流程。

<a href="https://glama.ai/mcp/servers/4fg1gxbcex"><img width="380" height="200" src="https://glama.ai/mcp/servers/4fg1gxbcex/badge" alt="Cursor Server MCP server" /></a>

快速开始 (Windows)

通过 Smithery 安装

要通过 Smithery 自动安装 Cursor for Claude Desktop：

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

手动安装

1. 先决条件

   • Node.js v18 或更高版本
   • 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. Fork 存储库
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 文件。

支持

如需支持：

• 在 GitHub 存储库中打开一个 issue
• 加入我们的 Discord 社区
• 查看 FAQ