Skip to main content
Glama
CTeaminfo

SuperiorAPIs MCP Server Tool

by CTeaminfo

SuperiorAPIs MCP 服务器工具

📖 描述

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

服务器将:

  • 获取插件元数据

  • 解析架构

  • 动态生成工具函数

  • 运行 MCP 服务器

Related MCP server: mcp-api-gateway

🚀 功能

  • 从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

服务器将:

  1. 从 SuperiorAPIs 获取插件数据

  2. 动态生成MCP工具函数

  3. 注册工具

  4. 启动 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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Turns 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 npm
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A universal MCP server that integrates any API with Claude Desktop by pointing it at a Swagger/OpenAPI spec, automatically generating tools for interaction.
    3
    44
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    A plugin-based MCP server built on FastAPI that supports dynamic tool loading, hot reloading, and API key authentication for extensible AI tool integrations.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Automatically generates MCP server tools from OpenAPI specifications, enabling LLMs to interact with any API defined by an OpenAPI spec through natural language.
    22 npm
    MIT