SuperiorAPIs MCP Server Tool
SuperiorAPIs MCP サーバーツール
📖 説明
このプロジェクトは、 SuperiorAPIからプラグイン定義を動的に取得し、OpenAPI スキーマに基づいて MCP ツール関数を自動生成する Python ベースのMCP サーバーです。
サーバーは次のことを行います。
プラグインのメタデータを取得する
スキーマを解析する
ツール関数を動的に生成する
MCPサーバーを実行する
Related MCP server: mcp-api-gateway
🚀 機能
SuperiorAPIsからの動的なプラグインの読み込み
pydanticモデルと非同期関数の自動生成aiohttpを使用した非同期 API 実行ランタイム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_hereWindows コマンドプロンプト
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_v2tokenヘッダー経由の承認が必要です。
🧠 生成されたツール関数の例
@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.whlDocker を使用して実行します (必要な場合):
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 deployed
Maintenance
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceTurns 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 npmMIT
- FlicenseAqualityDmaintenanceA universal MCP server that integrates any API with Claude Desktop by pointing it at a Swagger/OpenAPI spec, automatically generating tools for interaction.344-
- FlicenseNot gradedqualityDmaintenanceA plugin-based MCP server built on FastAPI that supports dynamic tool loading, hot reloading, and API key authentication for extensible AI tool integrations.-
- AlicenseNot gradedqualityDmaintenanceAutomatically generates MCP server tools from OpenAPI specifications, enabling LLMs to interact with any API defined by an OpenAPI spec through natural language.22 npmMIT