Awesome Cursor Mpc Server

🚀 🤖 AI 開發助手 MCP 服務器

本項目是一個專為 Cursor 設計的 Model Context Protocol (MCP) 服務器，屬於 AI 驅動的開發工具包。它藉助自定義 AI 工具，為開發者提供智能編碼輔助。不過要注意，這主要是一個教程演示項目，並非可用於生產環境的工具。

🚀 快速開始

環境設置

首先，你需要設置環境變量。創建一個文件 src/env/keys.ts：

export const OPENAI_API_KEY = "your_key_here";
// 添加其他任何所需的密鑰

⚠️ 安全注意：直接在源代碼中存儲 API 密鑰在生產環境中不推薦使用。這只是用於本地開發和學習目的。您也可以直接在 Cursor MCP 界面中設置環境變量。

安裝

npm install
# 或者
yarn install

構建服務器

npm run build

添加到 Cursor

該項目設計用於作為 Cursor 中的 MCP 服務器。以下是設置方法：

1. 打開 Cursor
2. 轉到 Cursor 設置 > 功能 > MCP
3. 點擊 + 添加新的 MCP 服務器
4. 填寫表單：
   • 名稱：AI 開發助手
   • 類型：stdio
   • 命令：node /path/to/your/project/dist/index.js

📘 技巧：您可能需要使用項目構建文件的完整路徑。

添加服務器後，您應該會在“可用工具”下看到工具列表。如果沒有，請嘗試點擊 MCP 服務器部分右上角的刷新按鈕。

有關更多 MCP 設置的詳細信息，請參閱 Cursor MCP 文檔。

✨ 主要特性

🎨 代碼架構師

調用高級推理 LLM 來生成計劃和指令，用於編碼代理。

📸 截圖 buddy

拍攝 UI 設計截圖並將其與作曲家代理一起使用。

🔍 代碼審查

使用 git 差分來觸發代碼審查。

💻 使用示例

配置完成後，您可以直接在 Cursor 的 Composer 中使用這些工具。AI 將會自動建議使用相關工具，或者您可以明確請求工具名稱或描述。

例如，在 Composer 中嘗試輸入：

• “審查此代碼的最佳實踐”
• “幫助我架構新功能”
• “分析此 UI 截圖”

代理將在執行任何工具調用之前詢問您的批准。

📘 技巧：您可以在 .cursorrules 文件中添加指令，說明在某些情況下如何使用工具，並且代理會自動使用這些工具。

📚 詳細文檔

項目結構

src/
├── tools/
│   ├── architect.ts    # 代碼結構生成器
│   ├── screenshot.ts   # 截圖分析工具
│   └── codeReview.ts   # 代碼審查工具
├── env/
│   └── keys.ts         # 環境配置（在此處添加您的 API 密鑰！）
└── index.ts           # 入口點

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

該項目在 MIT 許可證下分發 - 有關詳細信息，請參閱 LICENSE 文件。

🐛 問題與支持

發現錯誤或需要幫助？打開一個 Issues 時，請提供以下信息：

1. 您試圖完成的操作
2. 發生的情況
3. 復現步驟
4. 環境細節

我必須誠實地說，這是一個教程演示，而不是生產就緒工具，因此我可能不會修復問題。但請隨意 Fork 並自行開發！

由開發者為開發者製作，❤️