Superiorapis

🚀 SuperiorAPIs MCP サーバーツール

このツールはPythonベースのMCPサーバーで、SuperiorAPIs から動的にプラグイン定義を取得し、OpenAPIスキーマに基づいてMCPツール関数を自動生成します。

🚀 クイックスタート

このMCPサーバーは以下の手順で動作します：

1. プラグインメタデータを取得します。
2. スキーマを解析します。
3. pydantic モデルと非同期関数を動的に生成します。
4. MCPサーバーを起動します。

✨ 主な機能

• SuperiorAPIs の動的プラグインロード
• OpenAPIスキーマに基づくツール関数の自動生成
• aiohttp を使用した非同期API実行
• 実行時のMCPツール登録
• 環境設定のサポート
• UVXプラットフォームへのデプロイ準備

📦 インストール

プロジェクトをクローンし、依存関係をインストールします。

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 CMD

set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here

💻 使用例

基本的な使用法

MCPサーバーを起動します。

python main.py

このサーバーは以下の手順で動作します：

1. SuperiorAPIsからプラグインデータを取得します。
2. MCPツール関数を動的に生成します。
3. ツールを登録します。
4. MCPサーバーを起動します。

高度な使用法

以下は生成されるツール関数の例です。

@mcp.tool()
async def post_example_tool(param1: Optional[str] = None, param2: Optional[int] = None) -> str:
    """
    工具描述 | API 概要。

    # 参数：
        param1 (string, 可选): param1 的描述。
        param2 (integer, 可选): param2 的描述。

    # 返回值：
        200 (object): API 响应。
    """

📚 ドキュメント

🔗 API エンドポイント

プラグイン定義は以下のアドレスから取得されます。

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

token ヘッダーで認証を行います。

📦 パッケージング（オプション）

パッケージをビルドします。

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

📜 依存関係

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

❗ エラー処理

API呼び出しが失敗した場合、または status: 0 が返された場合、プログラムは以下のエラーメッセージを表示して終了します。

❌ 错误：API 返回无数据或状态为 0。请检查 API 是否正常工作。

📄 ライセンス

MIT License（または独自のライセンス）

👨‍💻 作者

あなたの名前 / あなたの会社
連絡先メールアドレス：your_email@example.com

📂 プロジェクト構造

.
├── main.py                 # MCP サーバーの核心ロジック
├── requirements.txt        # Python 依存関係のリスト
├── setup.py                # パッケージング設定
├── Dockerfile              # （オプション）Docker コンテナのビルドファイル
└── README.md               # プロジェクトドキュメント