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 链接]