MCP Server Collection

🚀 MCP 服務器集合

本項目是一個集成多種服務和 API 的模型上下文協議 (MCP) 服務器集合，旨在增強 AI 助手（如 Claude Desktop、Cursor、GitHub Copilot 等）的功能，為其提供更豐富的服務支持。

🚀 快速開始

此項目實現了多個 MCP 服務器，支持多種服務的集成，包括網絡搜索、文件系統管理、版本控制、設計資源操作等，為 AI 助手提供了強大的功能擴展。

✨ 主要特性

• Brave Search：使用 Brave Search API 提供網絡搜索功能。
• 文件系統：管理本地文件和目錄操作。
• Git：執行 Git 版本控制操作。
• GitHub：與 GitHub 倉庫進行交互。
• Shell：在終端中執行命令。
• Figma：操作 Figma 設計資源。
• Slack：與 Slack 進行通信。
• Firecrawl：進行網絡爬蟲任務。
• Notion：操作 Notion 工作空間中的數據。
• Think：提供複雜問題的結構化推理環境。

📦 安裝指南

1. 克隆此倉庫到本地：

   git clone https://github.com/yourusername/mcp-server.git
   cd mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 啟動 MCP 服務器：

   • 對於開發環境，請運行 npm run dev。
   • 對於生產環境，請使用 PM2 管理進程。

📚 詳細文檔

配置說明

每個 MCP 服務器的配置位於項目的 config 目錄中。請根據您的需求修改以下內容：

• API 密鑰：在 secrets.json 中添加所有必要的 API 憑據。
• 允許目錄：在 filesystem.json 中指定文件系統操作的授權路徑。
• 命令白名單：在 shell.json 中定義允許執行的 Shell 命令。

使用方法

1. 將 MCP 服務器添加到您的 AI 助手配置中：

   {
     "servers": [
       { "name": "brave-search", "url": "http://localhost:3000" },
       { "name": "filesystem", "url": "http://localhost:3001" },
       // 添加其他服務器配置
     ]
   }
   

2. 在您的 AI 助手代碼中引入所需模塊：

   import { FileSystem } from './src/filesystem';
   const fs = new FileSystem();
   

功能細節

文件系統

• 讀取文件：獲取指定路徑下的文件內容。
• 寫入文件：創建或覆蓋文件，寫入新內容。
• 列出目錄：返回指定目錄中的所有文件和子目錄。
• 刪除操作：刪除文件或空目錄。

Git 操作

• 克隆倉庫：從遠程 URL 克隆 Git 倉庫到本地。
• 提交更改：將修改後的文件提交到當前分支。
• 切換分支：在不同的 Git 分支之間進行切換。
• 拉取更新：從遠程倉庫獲取最新代碼併合併到當前分支。

GitHub 集成

• 創建新倉庫：使用 API 創建新的 GitHub 倉庫。
• Fork 倉庫：創建現有倉庫的 Fork。
• 提交更改：將本地修改推送到指定的遠程倉庫。
• 獲取倉庫信息：檢索特定倉庫的詳細信息，包括貢獻者和分支。

Shell 命令

• 執行命令：在終端中運行用戶提供的命令。
• 獲取輸出：返回命令的標準輸出、錯誤輸出及退出狀態碼。
• 文件操作：支持重命名、刪除和創建新文件或目錄。

Figma 設計

• 創建頁面：在 Figma 項目中添加新的設計頁面。
• 獲取組件：檢索特定組件的詳細信息，包括其屬性和版本歷史。
• 更新佈局：修改頁面中的元素位置和大小。
• 導出資源：將選定的設計資產導出為多種格式。

Slack 通信

• 發送消息：向指定頻道發送文本或 Markdown 格式的消息。
• 獲取聊天記錄：檢索特定時間段內的聊天曆史。
• 添加附件：上傳文件並附在消息中發送。
• 直接消息：向特定用戶發送私信。

網絡爬蟲

• 啟動爬蟲：使用指定的 URL 初始化爬蟲任務。
• 獲取結果：檢索爬取到的數據，包括 HTML 內容和鏈接。
• 設置規則：定義爬蟲的行為，如抓取深度和排除特定 URL。
• 中止任務：在任何時間點停止當前進行的爬蟲任務。

Notion 工作空間

• 創建頁面：添加新的 Notion 頁面或數據庫條目。
• 獲取內容：檢索指定頁面或數據庫中的所有記錄。
• 更新信息：修改現有頁面或數據庫條目的內容和屬性。
• 刪除數據：從工作區中刪除不再需要的內容。

複雜問題推理

• 提交查詢：將複雜的問題分解為多個子任務，逐一分析解決。
• 獲取中間結果：在推理過程中獲取每個步驟的輸出。
• 最終答案：返回經過驗證的最終結論和相關支持證據。

安全注意事項

1. 權限管理：嚴格限制 API 的訪問權限，避免未授權操作。
2. 輸入過濾：對用戶提供的輸入進行嚴格的驗證和消毒處理，防止注入攻擊。
3. 日誌記錄：記錄所有敏感操作日誌，便於審計和問題排查。

常見問題

1. 如何處理大文件上傳？
   • 使用分塊上傳機制，並設置適當的超時策略。
2. 遇到 Git 操作失敗怎麼辦？
   • 檢查網絡連接和倉庫權限，確保所有憑據正確配置。
3. 怎樣提高性能？
   • 優化數據庫查詢，減少不必要的網絡請求。

貢獻指南

1. 提交代碼前，請確保通過單元測試。
2. 遵循項目編碼規範，保持代碼風格一致。
3. 在提交 Pull Request 前，查閱貢獻者文檔以獲取更多細節。