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.

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

F

license - not found

-

quality - not tested

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.

SuperiorAPIs MCP Server Tool