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_here
Windows コマンドプロンプト
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_v2
tokenヘッダー経由の承認が必要です。
🧠 生成されたツール関数の例
@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.whl
Docker を使用して実行します (必要な場合):
docker build -t superiorapis-mcp .
docker run -e TOKEN=your_token -e APPLICATION_ID=your_app_id superiorapis-mcp
📄 ライセンス
MITライセンス（またはカスタムライセンス）
👨💻 著者
氏名 / 会社名
連絡先: your_email@example.com