AIGNE プロジェクト内の Agent をモデルコンテキストプロトコル (MCP) サーバーとして提供します。このコマンドは、ストリーミング可能な HTTP エンドポイントを介して Agent を公開し、MCP 標準をサポートする外部システムやアプリケーションとのシームレスな統合を可能にします。
内部的に、aigne serve-mcp は軽量な Express サーバーを起動します。設定されたエンドポイントで POST リクエストを受信すると、対応する Agent を呼び出し、MCP 仕様に従ってレスポンスをストリーミングで返します。
使用法
基本的な使用法
aigne serve-mcp [options]オプション
serve-mcp コマンドは、サーバーの動作をカスタマイズするために以下のオプションを受け入れます：
- --path, --url
string(default:.) — ローカルの Agent ディレクトリへのパス、またはリモートの AIGNE プロジェクトへの URL。 - --host
string(default:localhost) — MCP サーバーを実行するホスト。ネットワークにサーバーを公開するには0.0.0.0を使用します。 - --port
number(default:3000) — MCP サーバーのポート。PORT環境変数が設定されている場合、コマンドはそれを尊重します。それ以外の場合は、デフォルトで 3000 になります。 - --pathname
string(default:/mcp) — MCP サービスエンドポイントの URL パス。 - --aigne-hub-url
string— リモートの Agent 定義やモデルを取得するために使用される、カスタムの AIGNE Hub サービス URL。
例
ローカルプロジェクトのサーバーを起動する
現在のディレクトリから Agent を提供するには、オプションなしでコマンドを実行します。サーバーはデフォルトのホストとポートで起動します。
現在のディレクトリでサーバーを起動
aigne serve-mcp期待される出力:
コンソール出力
MCP server is running on http://localhost:3000/mcp特定のポートとパスで Agent を提供する
別のポートを指定し、AIGNE プロジェクトディレクトリへの明示的なパスを提供できます。
カスタムポートとパスでサーバーを起動
aigne serve-mcp --path ./my-ai-project --port 8080期待される出力:
コンソール出力
MCP server is running on http://localhost:8080/mcpサーバーをネットワークに公開する
MCP サーバーをネットワーク上の他のマシンからアクセス可能にするには、ホストを 0.0.0.0 に設定します。
サーバーを公開する
aigne serve-mcp --host 0.0.0.0期待される出力:
コンソール出力
MCP server is running on http://0.0.0.0:3000/mcp次のステップ
MCP サーバーを介して Agent を公開した後、本番環境用にデプロイすることを検討するとよいでしょう。