Cursor MCP

🚀 使用光标 MCP - Claude 桌面集成

这是一个 Model Context Protocol (MCP) 实现，借助 Cursor IDE，能让 Claude AI 与桌面应用程序实现无缝集成。该工具就像一座桥梁，将 Claude 的强大能力与桌面软件相结合，极大提升了 AI 驱动的开发工作流程效率。

🚀 快速开始（Windows）

先决条件

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

安装

# 全局安装
npm install -g mcp-cursor

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

配置

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

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

添加到 Claude 的 MCP 配置中

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

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

启动服务器

# 如果全局安装
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          # 环境配置

脚本

🤝 贡献

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