Herramienta de servidor MCP SuperiorAPIs

📖 Descripción

Este proyecto es un servidor MCP basado en Python que obtiene dinámicamente definiciones de complementos de SuperiorAPIs y genera automáticamente funciones de herramientas MCP basadas en esquemas OpenAPI.

El servidor hará lo siguiente:

Obtener metadatos del complemento
Analizar el esquema
Generar funciones de herramientas dinámicamente
Ejecutar el servidor MCP

🚀 Características

Carga dinámica de complementos desde SuperiorAPIs
Generación automática de modelos pydantic y funciones asíncronas
Ejecución asincrónica de API mediante aiohttp
Registro de la herramienta MCP en tiempo de ejecución
Admite configuración basada en el entorno
Listo para la implementación de la plataforma UVX

📂 Estructura del proyecto

.
├── 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

⚙️ Instalación

Clonar el proyecto e instalar las dependencias:

git clone https://your-repo-url.git
cd your-repo
pip install -r requirements.txt

🌍 Variables de entorno

Antes de ejecutar, configure las siguientes variables de entorno:

Linux/macOS

export TOKEN=your_token_here
export APPLICATION_ID=your_application_id_here

CMD de Windows

set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here

🖥️ Uso

Ejecute el servidor MCP:

python main.py

El servidor hará lo siguiente:

Obtener datos del complemento de SuperiorAPIs
Generar dinámicamente funciones de herramientas MCP
Registrar las herramientas
Iniciar el servidor MCP

Punto final de API

Las definiciones de complementos se obtienen de:

https://superiorapis-creator.cteam.com.tw/manager/module/plugins/list_v2

Se requiere autorización a través del encabezado token .

🧠 Ejemplo de función de herramienta generada

@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.
    """

📜 Requisitos

aiohttp>=3.8.6
pydantic>=2.5.3
mcp-sdk>=0.1.0

❗ Manejo de errores

Si la llamada API falla o devuelve status: 0 , el programa saldrá con:

❌ Error: API returned no data or status is 0. Please check if the API is working properly.

📦 Embalaje (opcional)

Construya el paquete:

python setup.py sdist bdist_wheel

Instalar el paquete:

pip install dist/mcp-superiorapis-1.0.0-py3-none-any.whl

Ejecutar usando Docker (si es necesario):

docker build -t superiorapis-mcp .
docker run -e TOKEN=your_token -e APPLICATION_ID=your_app_id superiorapis-mcp

📄 Licencia

Licencia MIT (o su licencia personalizada)

👨‍💻 Autor

Su nombre / Su empresa
Contacto: your_email@example.com

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

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.

Un servidor MCP basado en Python que obtiene dinámicamente definiciones de complementos de SuperiorAPIs y genera automáticamente funciones de herramientas basadas en esquemas OpenAPI, lo que permite una integración perfecta con los servicios de API.

Related MCP Servers

mcp-any-openapi
matthewhand
-
security
A
license
-
quality
A Python-based MCP server that integrates OpenAPI-described REST APIs into MCP workflows, enabling dynamic exposure of API endpoints as MCP tools.
Last updated -
2
39
Python
MIT License
MCP-OpenAPI
rmasters
-
security
A
license
-
quality
An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
Last updated -
2
Python
MIT License
OpenAPI Client Generator MCP
orhanveli
A
security
A
license
A
quality
A TypeScript-based MCP server that generates API clients from OpenAPI specifications, allowing automated code generation through natural language.
Last updated -
1
64
JavaScript
MIT License
Fastn Serverofficial
fastnai
-
security
A
license
-
quality
An MCP server that enables dynamic tool registration and execution based on API definitions, providing seamless integration with services like Claude.ai and Cursor.ai.
Last updated -
7
Python
MIT License

View all related MCP servers

SuperiorAPIs MCP Server Tool