MCP Superiorapis

🚀 スーパーAPI MCPサーバーツール

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

🚀 クイックスタート

このMCPサーバーを起動するには、まず必要な依存関係をインストールし、環境変数を設定する必要があります。以下の手順に従って操作してください。

インストール

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

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サーバーを起動します。

✨ 主な機能

• SuperiorAPIs から動的にプラグインをロードします。
• pydantic モデルと非同期機能を自動生成します。
• aiohttp を使用して非同期APIを実行します。
• 環境設定をサポートします。
• UVXプラットフォームへのデプロイに対応しています。

📦 インストール

プロジェクトをクローンし、依存関係をインストールする手順は以下の通りです。

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

💻 使用例

基本的な使用法

MCPサーバーを起動するには、以下のコマンドを実行します。

python main.py

高度な使用法

サーバーは以下の手順を自動的に実行します。

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

📚 ドキュメント

プロジェクト構造

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

APIエンドポイント

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

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:
    """
    ツールの説明 | APIの概要。

    # パラメータ:
        param1 (string, オプション): param1の説明。
        param2 (integer, オプション): param2の説明。

    # 戻り値:
        200 (object): APIのレスポンス。
    """

要件

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

エラー処理

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

❌ エラー：APIがデータを返さないか、ステータスが0です。APIが正常に動作しているか確認してください。

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

パッケージをビルドするには、以下のコマンドを実行します。

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ライセンス

作者情報

[あなたの名前またはチーム名]
[あなたの連絡先またはGitHubリンク]