Swagger

🚀 swagger-mcp 日本語ドキュメント

swagger-mcp は、Swagger UI を取得するためのツールです。swagger.json ファイルを抽出し、規範化された mcp ツールを動的に生成し、実行時に MCP クライアントが選択して使用できます。

🚀 クイックスタート

前提条件

swagger-mcp を使用する前に、以下の依存関係がインストールされていることを確認してください。

1. LLM モデル API キー / ローカル LLM：OpenAI、Claude、または Ollama モデルへのアクセス権が必要です。
2. 任意の MCP クライアント：（例として mark3labs - mcphost を使用）

インストールと構成

swagger-mcp をインストールして実行するには、以下の手順に従ってください。

go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp

実行構成

swagger-mcp を直接実行するには、次のコマンドを使用します。

swagger-mcp --specUrl=https://your_swagger_api_docs.json

主なパラメータ：

• --specUrl：Swagger/OpenAPI JSON URL（必須）
• --sseMode：SSE モードで実行します（デフォルト：false。true の場合、SSE サーバーとして実行します。それ以外の場合は、標準入出力を使用します）
• --sseAddr：SSE サーバーのリスニングアドレス。IP:Port または :Port の形式で指定します（空の場合、--sseUrl に基づいて自動的に補完されます）
• --sseUrl：SSE サーバーのベース URL（空の場合、デフォルトで http://IP:Port または http://localhost:Port が生成されます）
• --sseAddr と --sseUrl を同時に設定する場合は、具体的なドキュメントを参照してください。
• その他のパラメータについては、ツールの説明を参照してください。

MCP 構成

.mcp.json ファイルで mcphost を次のように構成します。

{
  "swagger-mcp": {
    "url": "https://your_swagger_api_docs.json",
    "sseMode": false,
    "sseAddr": ":8080"
  }
}

デモンストレーションの流れ

バックエンド、Ollama、および MCP クライアントの実行コマンドは次のとおりです。

# バックエンドサービス
go run main.go

# Ollama サービス
ollama serve --model gpt-3

# MCP クライアント
go run client.go

✨ 主な機能

swagger-mcp は、Swagger UI を取得し、swagger.json ファイルを抽出して規範化された mcp ツールを動的に生成することができます。これにより、MCP クライアントは実行時に選択して使用することができます。

📦 インストール

go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp

📚 ドキュメント

📽️ デモビデオ

プロジェクトの機能を理解するためにデモビデオを見ることができます。

🙌 サポート

このプロジェクトが価値があると思われる場合は、LinkedIn で私をサポートしてください。

• 👍 私のデモ投稿にいいねして共有してください。
• 💬 コメントセクションにあなたの考えやフィードバックを残してください。
• 🔗 将来の更新情報を得るために、私をフォローしてください。

あなたのサポートは、私がより多くの人に到達し、プロジェクトを改善するのに役立ちます！

フローチャート

プロジェクトのフローチャートを表示するには、次のリンクを参照してください。フローチャートリンク

改善点

ユーザーから次の改善点が指摘されています。

• ツール定義：ツールの定義方法をより規範化し、可用性を向上させる必要があります。
• LLM 動作制御：LLM モデルの制御能力を強化し、出力が期待通りになるようにする必要があります。
• コンテキスト管理：コンテキスト処理メカニズムを最適化し、会話の一貫性を向上させる必要があります。
• エラー処理：異常検出と回復メカニズムを強化し、ツールの堅牢性を向上させる必要があります。

これらの改善により、swagger-mcp はより完成度の高いものになります。フィードバックや提案を歓迎します！