MCP Server Pool

🚀 MCP 服務器池

MCP 服務器池是一個 MCP（模型上下文協議）服務器倉庫，這裡不僅有多種實用的 MCP 服務實現，還提供了從零開始開發的教學教程，能助力開發者輕鬆上手 MCP 開發。

🚀 快速開始

此項目適合對 MCP 開發感興趣的開發者，若你想使用其中的服務，可根據自身需求查看對應服務的功能及使用說明；若你想學習 MCP 開發，可參考 tutorial/ 目錄下的教程。

✨ 主要特性

• 提供多種 MCP 服務實現，涵蓋 Git 操作、Google Sheets 交互、Jenkins 操作、文件操作等多個領域。
• 包含從零開始的 MCP 開發教程，方便新手入門。
• 遵循一定的開發規範，利於倉庫的一致性和可維護性。

📦 安裝指南

環境要求

• Python 3.10+
• FastMCP 庫

💻 使用示例

基礎用法

由於未提供具體代碼示例，可參考以下步驟使用各服務：

• Git 操作服務：進入 git-options/ 目錄，根據需求調用相應功能。
• Google Sheets MCP 工具：進入 google-sheet-mcp/ 目錄，使用其提供的功能與 Google Sheets 和 Google Docs 交互。
• Jenkins 操作工具：進入 jk-option/ 目錄，對 Jenkins 服務器進行各種操作。
• 文件操作服務：進入 file-option/ 目錄，進行文件系統操作。

高級用法

若你想開發新的 MCP 服務，可參考 tutorial/ 目錄下的教程，按照教程步驟從零開始開發。

📚 詳細文檔

項目結構

mcp-servers/
├── git-options/        # Git 操作相關的 MCP 服務
├── google-sheet-mcp/   # Google Sheets 和文檔交互相關的 MCP 服務
├── jk-option/          # Jenkins 操作相關的 MCP 服務
├── file-option/        # 文件操作相關的 MCP 服務
├── tutorial/           # 從零開始的 MCP 開發教程
└── ...                 # 其他 MCP 服務

服務列表

Git 操作服務

位於 git-options/ 目錄，提供與 Git 相關操作的 MCP 服務，包括：

• 初始化倉庫
• 添加/提交更改
• 分支管理
• 遠程倉庫操作
• 憑證管理
• 用戶配置

Google Sheets MCP 工具

位於 google-sheet-mcp/ 目錄，提供與 Google Sheets 和 Google Docs 交互的 MCP 服務，包括：

• 文檔列表查詢：列出所有可訪問的 Google 文件、表格和文檔
• 文檔下載：下載 Google 表格（支持 Excel、CSV、JSON 格式）和文檔（支持 DOCX、TXT 格式）
• 週報更新：查找和更新 Google Sheets 中的週報內容
• 安全認證：使用 Google 服務賬號進行安全認證

Jenkins 操作工具

位於 jk-option/ 目錄，提供 Jenkins 服務器的各種操作功能，包括：

• 獲取所有 Jenkins 項目列表
• 獲取指定項目的構建參數
• 根據傳入的參數觸發構建
• 獲取構建狀態
• 終止指定構建
• 項目別名處理功能（例如將完整項目名映射為簡短別名）

文件操作服務

位於 file-option/ 目錄，提供全面的文件系統操作功能，旨在解決 Cherry Studio 等對話軟件在文件操作方面的侷限性：

• 文件的讀取與寫入
• 文件的創建與刪除
• 文件的複製與移動
• 目錄的創建與刪除
• 文件權限的修改
• 文件信息的獲取

⚠️ 重要提示

使用文件操作服務時，請謹慎執行刪除操作，因為這些操作是真實有效的，一旦執行將無法恢復。

從零開始的 MCP 開發教程

位於 tutorial/ 目錄，這是一個完整的教程，指導您如何從零開始開發 MCP 服務：

教程內容

1. 基礎概念
   • MCP 架構介紹
   • 服務設計原則
   • 開發環境搭建
2. 創建第一個 MCP 服務
   • 項目結構設置
   • 基本框架編寫
   • 工具函數定義

開發指南

環境要求

• Python 3.10+
• FastMCP 庫

模塊提交

為了保持倉庫的一致性和可維護性，請遵循以下規範：

目錄結構規範

1. 每個模塊必須創建獨立目錄
   • 每個 MCP 服務模塊必須創建一個獨立的目錄
   • 目錄名應使用小寫字母和連字符，例如：weather-service、text-translator
2. 不需要包含項目基礎框架文件
   • 不要提交項目的基礎框架文件
   • 專注於模塊的具體實現

貢獻指南

歡迎貢獻新的 MCP 服務或改進現有服務！

📄 許可證

MIT License