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

license - not found

quality - not tested

How are these scores calculated?

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.

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

Related MCP Servers

mcp-any-openapi
matthewhand
-
security
A
license
-
quality
A Python-based MCP server that integrates OpenAPI-described REST APIs into MCP workflows, enabling dynamic exposure of API endpoints as MCP tools.
Last updated -
2
39
Python
MIT License
MCP-OpenAPI
rmasters
-
security
A
license
-
quality
An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
Last updated -
2
Python
MIT License
OpenAPI Client Generator MCP
orhanveli
A
security
A
license
A
quality
A TypeScript-based MCP server that generates API clients from OpenAPI specifications, allowing automated code generation through natural language.
Last updated -
1
64
JavaScript
MIT License
Fastn Serverofficial
fastnai
-
security
A
license
-
quality
An MCP server that enables dynamic tool registration and execution based on API definitions, providing seamless integration with services like Claude.ai and Cursor.ai.
Last updated -
7
Python
MIT License

View all related MCP servers

SuperiorAPIs MCP Server Tool