MCP Superiorapis

🚀 超級API MCP 服務器工具

本項目是一個基於 Python 的 MCP 服務器，它能夠從 SuperiorAPIs 動態獲取插件定義，並依據 OpenAPI 模式自動生成 MCP 工具函數。藉助此工具，可高效實現插件的動態加載與 MCP 工具函數的自動生成。

🚀 快速開始

克隆項目並安裝依賴：

git clone https://your-repo-url.git
cd your-repo
pip install -r requirements.txt

運行前設置以下環境變量：

Linux/macOS

export TOKEN=your_token_here
export APPLICATION_ID=your_application_id_here

Windows CMD

set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here

運行 MCP 服務器：

python main.py

服務器將按以下步驟執行：

1. 從 SuperiorAPIs 獲取插件數據
2. 動態生成 MCP 工具函數
3. 註冊工具
4. 啟動 MCP 服務器

✨ 主要特性

• 從 SuperiorAPIs 動態加載插件
• 自動生成 pydantic 模型和異步功能
• 使用 aiohttp 執行異步 API
• 支持環境配置
• 準備用於 UVX 平臺部署

📦 安裝指南

克隆項目並安裝依賴

git clone https://your-repo-url.git
cd your-repo
pip install -r requirements.txt

環境變量設置

運行前需設置以下環境變量：

Linux/macOS

export TOKEN=your_token_here
export APPLICATION_ID=your_application_id_here

Windows CMD

set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here

💻 使用示例

基礎用法

運行 MCP 服務器：

python main.py

高級用法

包裝（可選）

構建包：

python setup.py sdist bdist_wheel

安裝包：

pip install dist/mcp-superiorapis-1.0.0-py3-none-any.whl

使用 Docker 運行（如果需要）：

docker build -t superiorapis-mcp .
docker run -e TOKEN=your_token -e APPLICATION_ID=your_app_id superiorapis-mcp

📚 詳細文檔

項目結構

.
├── main.py                 # MCP 服務器核心邏輯
├── requirements.txt        # Python 依賴列表
├── setup.py                # 包裝設置
├── Dockerfile              # （可選）Docker 容器構建文件
└── README.md               # 項目文檔

API 端點

插件定義從以下地址獲取：

https://superiorapis-creator.cteam.com.tw/manager/module/plugins/list_v2

通過 token 頭進行授權。

示例生成工具函數

@mcp.tool()
async def post_example_tool(param1: Optional[str] = None, param2: Optional[int] = None) -> str:
    """
    工具描述 | API 概述。

    # 參數：
        param1 (string, 可選): param1 的描述。
        param2 (integer, 可選): param2 的描述。

    # 返回：
        200 (object): API 響應。
    """

需求

aiohttp>=3.8.6
pydantic>=2.5.3
mcp-sdk>=0.1.0

錯誤處理

如果 API 調用失敗或返回 status: 0，程序將退出並顯示：

❌ 錯誤：API 返回無數據或狀態為 0。請檢查 API 是否正常工作。

🔧 技術細節

該服務器主要執行以下操作：

• 獲取插件元數據
• 解析模式
• 動態生成 pydantic 模型和異步函數
• 運行 MCP 服務器

📄 許可證

MIT 許可證

作者信息

[你的姓名或團隊名稱]
[你的聯繫方式或 GitHub 鏈接]