Openapi2mcpserver

🚀 OpenAPI to MCP Server

简体中文 | English

このプロジェクトは、提供されたopenapi.yamlから直接Model Context Protocol (MCP)サーバーを起動します。依存関係の管理にはuvを使用しています。すべてのHTTPエンドポイントは、AnythingLLM（またはMCP対応のクライアント）が呼び出せるMCPツールになります。

🚀 クイックスタート

1. 依存関係のインストール

uv sync

2. openapi2mcpserver/config.yamlの設定

base_url: "https://localhost:12001"
verify_ssl: false
openapi_path: "../openapi.yaml"           # オプション、デフォルトはリポジトリのルートにあるコピー
log_file: "../logs/openapi2mcpserver.log" # オプション、ファイルロギングを有効にする
log_level: "INFO"                         # オプション、DEBUG/INFO/WARNING/ERRORをサポート

auth:
  mode: "basic"                           # オプション: none/basic/bearer/header/query
  username: "your-username"
  password: "your-password"
  # basic_token: "cHJlLWVuY29kZWQtY3JlZHM="
  # extra_headers:
  #   X-API-Version: "1"

# default_headers:
#   X-Request-Source: "mcp"

3. MCPサーバーの起動

uv run openapi2mcpserver

💻 使用例

AnythingLLMでのこのMCPサーバーの使用

以下の手順はAnythingLLMデスクトッププラグインシステムを対象としており、macOSとWindowsのデフォルトのパスをリストしています。ファイルが存在しない場合は作成し、サンプルのパスをあなたのマシン上の値に置き換えてください。

macOS

1. ~/Library/Application Support/anythingllm-desktop/storage/plugins/anythingllm_mcp_servers.jsonを開きます。
2. 以下の設定を追加またはマージします。

{
  "mcpServers": {
    "rhino-agent": {
      "command": "/Users/<你的用户名>/.local/bin/uv",
      "args": ["run", "--project", "/Users/<你的用户名>/workspace/AIProjects/openapi2mcpserver", "openapi2mcpserver"]
    }
  }
}

Windows

1. %APPDATA%\anythingllm-desktop\storage\plugins\anythingllm_mcp_servers.jsonを開きます。
2. uv.exeを使用している場合は、パスをwhere uvの出力で置き換えます。例えば：

{
  "mcpServers": {
    "rhino-agent": {
      "command": "C:\\Users\\<YourUser>\\AppData\\Roaming\\Python\\Scripts\\uv.exe",
      "args": ["run", "--project", "C:\\Users\\<YourUser>\\workspace\\AIProjects\\openapi2mcpserver", "openapi2mcpserver"]
    }
  }
}

保存後にAnythingLLMを再起動するか（または設定でプラグインを再読み込みして）、ワークスペースのツールリストにrhino-agentが表示されるはずです。

✨ 主な機能

• すべてのOpenAPIパスを自動的に解析し、一致するMCPツールを登録します。
• components.schemasを調査するためのOpenAPI_GetSchemaを公開します。
• ツールの入力には、パスパラメータ、クエリパラメータ、ヘッダー、およびリクエストボディが含まれます。
• 柔軟な認証（none/basic/bearer/custom header/query）とグローバルなデフォルトヘッダーをサポートします。
• コンソールとファイルの両方に構造化ログを出力し、LLMのトラブルシューティングを容易にします。

📚 ドキュメント

レイアウト

openapi2mcpserver/
    __init__.py
    __main__.py
    client.py
    config.py
    openapi_loader.py
    server.py

ランタイムに関する注意事項

起動時に、サーバーはOpenAPIの説明を取り込み、各ツールのJSONスキーマ入力を構築し、呼び出しを上流のAPIに転送します。レスポンス（ステータス、ヘッダー、およびJSON/テキストボディ）はそのままMCPクライアントに返されるため、タスクのステータスをポーリングするなどの後続のアクションをチェーンすることができます。