Adampippert Multi Service MCP Server

🚀 模型上下文協議（MCP）服務器

模型上下文協議（MCP）服務器是一個基於Flask框架構建的Web服務，它藉助統一標準接口，為多個工具賦予交互能力，支持GitHub、GitLab、Google Maps、Memory和Puppeteer等工具的操作，極大提升了工具間的協作效率。

🚀 快速開始

模型上下文協議（Model Context Protocol，簡稱MCP）服務器是一個基於Flask框架構建的Web服務。它通過統一的標準接口為多個工具提供交互能力，支持GitHub、GitLab、Google Maps、Memory和Puppeteer等工具的操作。

✨ 主要特性

• 模塊化架構：採用模塊化架構設計，各部分分工明確，便於維護和擴展。
• 統一接口：所有工具通過統一的MCP協議與服務器交互，支持多種調用方式。
• 自動文檔生成：文檔生成模塊可自動生成API文檔，方便開發者使用。

📦 安裝指南

文檔中未提及具體安裝步驟，故跳過此章節。

💻 使用示例

基礎用法

# 假設使用統一接口 /mcp 進行跨工具請求
import requests

url = 'http://your-server-address/mcp'
data = {
    "tool": "github",
    "operation": "listRepos",
    "parameters": {
        "user": "your_username"
    }
}

response = requests.post(url, json=data)
print(response.json())

高級用法

# 使用工具專屬接口獲取GitHub指定倉庫信息
import requests

url = 'http://your-server-address/tool/github/getRepo'
data = {
    "parameters": {
        "repo": "your_repo_name"
    }
}

response = requests.post(url, json=data)
print(response.json())

📚 詳細文檔

架構

該服務器採用模塊化架構設計，分為以下幾個核心部分：

• 工具管理器：負責工具的註冊、發現與調用。
• 請求處理層：解析用戶請求並分發到相應工具。
• 響應生成層：根據工具返回結果生成標準格式的響應。
• 文檔生成模塊：自動生成API文檔。

功能

標準接口

所有工具通過統一的MCP協議與服務器交互，支持以下兩種調用方式：

1. 統一接口 /mcp：處理所有跨工具請求。
2. 工具專屬接口：如 /tool/github/listRepos。

MCP 信息 manifest

提供 /mcp/manifest 端點，返回所有可用工具及其操作的詳細說明。

工具文檔

GitHub 工具

支持以下操作：

• listRepos：列出用戶或組織的所有倉庫。
• getRepo：獲取指定倉庫的信息。
• searchRepos：搜索符合條件的倉庫。
• getIssues：獲取倉庫中的問題列表。
• createIssue：新建倉庫中的一個問題。

GitLab 工具

支持以下操作：

• listProjects：列出用戶可訪問的所有項目。
• getProject：獲取指定項目的詳細信息。
• searchProjects：搜索符合條件的項目。
• getIssues：獲取項目中的問題列表。
• createIssue：新建項目中的一個問題。
• getPipelines：獲取項目的流水線信息。

Google Maps 工具

支持以下操作：

• geocode：將地址轉換為地理座標。
• reverseGeocode：將地理座標轉回地址。
• getDirections：獲取兩點之間的路線規劃。
• searchPlaces：搜索附近的地點信息。
• getPlaceDetails：獲取特定地點的詳細信息。

Memory 工具

提供持久化的鍵值存儲服務，支持以下操作：

• get：通過鍵獲取存儲項。
• set：創建或更新存儲項。
• delete：刪除指定鍵的存儲項。
• list：列出所有存儲項，可按條件過濾。
• search：根據內容搜索存儲項。

Puppeteer 工具

提供網頁自動化功能，支持以下操作：

• screenshot：截取網頁快照。
• pdf：生成網頁的PDF文件。
• extract：提取網頁中的內容信息。

貢獻指南

歡迎社區貢獻！以下是參與方式：

添加新工具

1. 在tools目錄下創建新工具文件，如tools/newtool_tool.py。
2. 實現該工具的具體操作方法，參考現有工具的實現模式。
3. 將新工具添加到manifest配置中。
4. 註冊工具的藍圖路由。

🔧 技術細節

該服務器採用模塊化架構設計，各核心部分協同工作，實現了工具的統一管理和交互。工具管理器負責工具的全生命週期管理，請求處理層確保用戶請求的準確分發，響應生成層保證了響應的標準化，文檔生成模塊則提高了開發效率。

📄 許可證

本項目遵循MIT許可證，具體內容詳見 LICENSE 文件。

致謝

感謝以下項目的貢獻：

• 模型上下文協議（Model Context Protocol）為規範提供了標準。
• Flask框架為Web服務構建奠定了基礎。
• Puppeteer為網頁自動化提供了強大支持。