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.

Used for automatically generating data models from OpenAPI schemas, providing data validation and serialization for the dynamically loaded plugin definitions.

The core language used to implement the MCP server that dynamically generates tool functions based on plugin definitions from SuperiorAPIs.

SuperiorAPIs MCP Server Tool

📖 Description

This project is a Python-based MCP Server that dynamically fetches plugin definitions from SuperiorAPIs and auto-generates MCP tool functions based on OpenAPI schemas.

The server will:

Fetch plugin metadata
Parse the schema
Generate tool functions dynamically
Run the MCP server

Related MCP server: Lodestar MCP Server

🚀 Features

Dynamic plugin loading from SuperiorAPIs
Auto-generation of pydantic models and async functions
Asynchronous API execution using aiohttp
Runtime MCP tool registration
Supports environment-based configuration
Ready for UVX platform deployment

📂 Project Structure

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

⚙️ Installation

Clone the project and install the dependencies:

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

🌍 Environment Variables

Before running, set the following environment variables:

Linux/macOS

export TOKEN=your_token_here export APPLICATION_ID=your_application_id_here

Windows CMD

set TOKEN=your_token_here set APPLICATION_ID=your_application_id_here

🖥️ Usage

Run the MCP server:

python main.py

The server will:

Fetch plugin data from SuperiorAPIs
Dynamically generate MCP tool functions
Register the tools
Start the MCP server

🔗 API Endpoint

Plugin definitions are fetched from:

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

Authorization is required via the token header.

🧠 Example Generated Tool Function

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

📜 Requirements

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

❗ Error Handling

If the API call fails or returns status: 0, the program will exit with:

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

📦 Packaging (Optional)

Build the package:

python setup.py sdist bdist_wheel

Install the package:

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

Run using Docker (if needed):

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

📄 License

MIT License (or your custom license)

👨‍💻 Author

Your Name / Your Company
Contact: your_email@example.com

SuperiorAPIs MCP Server Tool

SuperiorAPIs MCP Server Tool

📖 Description

🚀 Features

📂 Project Structure

⚙️ Installation

🌍 Environment Variables

🖥️ Usage

🔗 API Endpoint

🧠 Example Generated Tool Function

📜 Requirements

❗ Error Handling

📦 Packaging (Optional)

📄 License

👨‍💻 Author

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API