Windsurf Tools

🚀 🤖 AI開發助手 MCP 服務器

本項目是一款由AI驅動的開發工具包，專為Cursor的Model Context Protocol (MCP) 服務器量身打造！它藉助自定義AI工具，為開發者提供智能編碼輔助，有效提升編碼效率與質量。

⚠️ 重要提示

這是一個主要用於本地開發和學習的教程演示項目，並非生產就緒工具。

✨ 主要特性

🎨 代碼架構師

調用高級推理大語言模型（LLM），為編碼代理生成計劃和指令，助力構建高效、合理的代碼架構。

📸 截圖幫手

捕獲UI設計截圖，並與作曲家代理協同工作，方便進行UI相關的開發與分析。

🔍 代碼審查

通過git差異觸發代碼審查，精準定位代碼中的問題和優化點。

📄 讀取文件 & 讀取多個文件

單文件閱讀可顯著提高數據解析效率；多文件閱讀則便於批量處理數據，滿足不同場景的需求。

🚀 快速開始

1. 環境配置

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

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

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

2. 安裝

npm install
# 或者
yarn install

3. 構建服務器

npm run build

4. 打開Windsurf聊天並配置MCP

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

1. 在您的系統上打開Windsurf。
2. 導航到“聊天”部分。
3. 點擊 + 配置MCP（這允許您添加一個新的MCP服務器）。
4. 添加以下JSON配置：

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "D:\\mpc-server\\build\\index.js"
      ]
    }
  }
}

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

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

有關更多設置詳情，請參閱 Windsurf MCP 文檔。

🛠️ 使用示例

基礎用法

一旦配置完成，您就可以在Cursor的作曲家中直接使用這些工具。AI會自動建議使用相關工具，或者您可以明確要求使用名稱或描述的工具。

例如，在作曲家中嘗試輸入：

• "審查此代碼的最佳實踐"
• "幫助我架構新功能"
• "分析此UI截圖"
• "讀取單個文件 & 讀取多個文件"

代理會詢問您的批准後再調用任何工具。

高級用法

您可以更新.cursorrules文件，添加在特定場景下使用工具的說明，代理將自動使用工具，進一步提升開發效率。

📚 詳細文檔

項目結構

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