Cursor IDE

🚀 游.Cursor MCP - 与Claude桌面集成的桌面应用程序

游.Cursor MCP是一个模型上下文协议（MCP）的实现，它能让Claude AI与桌面应用通过Cursor IDE实现无缝集成。此工具就像一座桥梁，连接Claude功能与桌面软件，显著增强了AI驱动的开发工作流程。

🚀 快速开始

Windows系统

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. 叉克隆仓库。
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仓库中打开一个问题。
• 加入我们的Discord社区。
• 查看FAQ 。