返回市场
光标-mcp

光标-mcp

作者:Buga-luga38 星标更新:2025-05-16

项目介绍

Cursor MCP - Claude Desktop 集成

smithery 徽章

这是一个模型上下文协议(MCP)实现,它通过Cursor IDE实现了Claude AI与桌面应用程序之间的无缝集成。此工具作为Claude功能与桌面软件之间的桥梁,支持增强的人工智能驱动开发工作流程。

<a href="https://glama.ai/mcp/servers/4fg1gxbcex"><img width="380" height="200" src="https://gips0.baidu.com/it/u=1582664795,2187644352&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Cursor Server MCP 服务器" /></a>

快速开始(Windows)

通过 Smithery 安装

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

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

手动安装

  1. 前提条件

  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
    

功能

  • 开发工作流程中的实时人工智能辅助
  • 上下文感知的代码建议和补全
  • 与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 '添加功能')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

MIT 许可证 - 详情见 LICENSE 文件。

运行评估

Evals 包加载了一个 mcp 客户端,然后运行 index.ts 文件,因此在测试之间无需重建。您可以通过在 npx 命令前缀加载环境变量。完整的文档可以在这里找到 这里

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/tools/cursor-tools.ts

支持

对于支持: