remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for making asynchronous HTTP requests to external APIs, enabling the MCP server to fetch data from SuperiorAPIs endpoints.
Provides containerization support for the MCP server, allowing for consistent deployment across different environments with proper environment variable configuration.
Supported as a runtime environment for the MCP server, with specific environment variable setup instructions provided.

SuperiorAPIs MCP サーバーツール

📖 説明

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

サーバーは次のことを行います。

プラグインのメタデータを取得する
スキーマを解析する
ツール関数を動的に生成する
MCPサーバーを実行する

🚀 機能

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

SuperiorAPI からプラグイン定義を動的に取得し、OpenAPI スキーマに基づいてツール関数を自動生成し、API サービスとのシームレスな統合を可能にする Python ベースの MCP サーバーです。

SuperiorAPIs MCP Server Tool