SuperiorAPIs MCP サーバーツール
📖 説明
このプロジェクトは、 SuperiorAPIからプラグイン定義を動的に取得し、OpenAPI スキーマに基づいて MCP ツール関数を自動生成する Python ベースのMCP サーバーです。
サーバーは次のことを行います。
プラグインのメタデータを取得する
スキーマを解析する
ツール関数を動的に生成する
MCPサーバーを実行する
Related MCP server: Lodestar MCP Server
🚀 機能
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 installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.