remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for making asynchronous HTTP requests to external APIs, enabling the MCP server to fetch data from SuperiorAPIs endpoints.
Provides containerization support for the MCP server, allowing for consistent deployment across different environments with proper environment variable configuration.
Supported as a runtime environment for the MCP server, with specific environment variable setup instructions provided.

SuperiorAPIs MCP 服务器工具

📖 描述

该项目是一个基于 Python 的MCP 服务器，它从SuperiorAPIs动态获取插件定义并根据 OpenAPI 模式自动生成 MCP 工具功能。

服务器将：

获取插件元数据
解析架构
动态生成工具函数
运行 MCP 服务器

🚀 功能

从SuperiorAPIs动态加载插件
自动生成pydantic模型和异步函数
使用aiohttp执行异步 API
Runtime 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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

基于 Python 的 MCP 服务器，可从 SuperiorAPIs 动态获取插件定义并根据 OpenAPI 模式自动生成工具功能，从而实现与 API 服务的无缝集成。

SuperiorAPIs MCP Server Tool