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_hereWindows 命令
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
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.