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