SuperiorAPIs MCP Server Tool
SuperiorAPIs MCP 服务器工具
📖 描述
该项目是一个基于 Python 的MCP 服务器,它从SuperiorAPIs动态获取插件定义并根据 OpenAPI 模式自动生成 MCP 工具功能。
服务器将:
获取插件元数据
解析架构
动态生成工具函数
运行 MCP 服务器
Related MCP server: mcp-api-gateway
🚀 功能
从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 deployed
Maintenance
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceTurns any OpenAPI specification into a fully working MCP server with a single command, enabling AI agents to call APIs without writing any glue code.7 npmMIT
- FlicenseAqualityDmaintenanceA universal MCP server that integrates any API with Claude Desktop by pointing it at a Swagger/OpenAPI spec, automatically generating tools for interaction.344-
- FlicenseNot gradedqualityDmaintenanceA plugin-based MCP server built on FastAPI that supports dynamic tool loading, hot reloading, and API key authentication for extensible AI tool integrations.-
- AlicenseNot gradedqualityDmaintenanceAutomatically generates MCP server tools from OpenAPI specifications, enabling LLMs to interact with any API defined by an OpenAPI spec through natural language.22 npmMIT