SuperiorAPIs MCP 服务器工具
📖 描述
该项目是一个基于 Python 的MCP 服务器，它从SuperiorAPIs动态获取插件定义并根据 OpenAPI 模式自动生成 MCP 工具功能。
服务器将：
获取插件元数据
解析架构
动态生成工具函数
运行 MCP 服务器
Related MCP server: Lodestar MCP Server
🚀 功能
从SuperiorAPIs动态加载插件
自动生成
pydantic模型和异步函数使用
aiohttp执行异步 APIRuntime MCP 工具注册
支持基于环境的配置
准备部署UVX平台
📂 项目结构
.
├── main.py # MCP server core logic
├── requirements.txt # Python dependency list
├── setup.py # Packaging setup
├── Dockerfile # (Optional) Docker container build file
└── README.md # Project documentation
⚙️ 安装
克隆项目并安装依赖项：
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 命令
set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here
🖥️ 使用方法
运行 MCP 服务器：
python main.py
服务器将：
从 SuperiorAPIs 获取插件数据
动态生成MCP工具函数
注册工具
启动 MCP 服务器
🔗 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:
"""
Tool description | API summary.
# Args:
param1 (string, optional): Description of param1.
param2 (integer, optional): Description of param2.
# Returns:
200 (object): API response.
"""
📜 要求
aiohttp>=3.8.6
pydantic>=2.5.3
mcp-sdk>=0.1.0
❗ 错误处理
如果 API 调用失败或返回status: 0 ，程序将退出：
❌ Error: API returned no data or status is 0. Please check if the API is working properly.
📦包装（可选）
构建包：
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
📄 许可证
MIT 许可证（或您的自定义许可证）
👨💻作者
您的姓名/您的公司
联系方式： your_email@example.com