跳到主要內容

aigne serve-mcp

將 AIGNE 專案中的 Agent 作為模型情境協定(MCP)伺服器來提供服務。此命令透過可串流的 HTTP 端點公開您的 Agent,從而實現與支援 MCP 標準的外部系統和應用程式的無縫整合。

在內部,aigne serve-mcp 會啟動一個輕量級的 Express 伺服器。當在配置的端點上收到 POST 請求時,它會調用相應的 Agent,並根據 MCP 規範以串流方式回傳響應。

執行 MCP 服務

用法

基本用法

bash
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 服務,請不帶任何選項執行此命令。伺服器將在預設主機和連接埠上啟動。

在目前目錄啟動伺服器

bash
aigne serve-mcp

預期輸出:

控制台輸出

text
MCP server is running on http://localhost:3000/mcp

在特定連接埠和路徑上提供 Agent 服務

您可以指定不同的連接埠,並提供到您的 AIGNE 專案目錄的明確路徑。

使用自訂連接埠和路徑啟動伺服器

bash
aigne serve-mcp --path ./my-ai-project --port 8080

預期輸出:

控制台輸出

text
MCP server is running on http://localhost:8080/mcp

將伺服器公開到網路上

要讓您的 MCP 伺服器可從網路上其他機器存取,請將主機設定為 0.0.0.0。

公開伺服器

bash
aigne serve-mcp --host 0.0.0.0

預期輸出:

控制台輸出

text
MCP server is running on http://0.0.0.0:3000/mcp

後續步驟

透過 MCP 伺服器公開您的 Agent 後,您可能會希望將它們部署以供生產使用。