将 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 后,您可能希望将它们部署用于生产环境。