將 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— 自訂的 AIGNE Hub 服務 URL,用於獲取遠端 Agent 定義或模型。
範例
為本地專案啟動伺服器
要從目前目錄提供 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 後,您可能會希望將它們部署以供生產使用。