Serve 命令

使用各种传输和配置选项启动 1MCP 服务器。

摘要

npx -y @1mcp/agent [serve] [options]
npx -y @1mcp/agent [options]  # serve 是默认命令

描述

serve 命令启动 1MCP 服务器，该服务器充当多个 MCP 服务器的统一代理/多路复用器。它可以在不同的传输模式下运行，并为 MCP 客户端提供统一的接口。

有关命令行标志、环境变量和 JSON 配置选项的完整列表，请参阅 配置深入指南。有关 MCP 服务器配置（后端服务器、环境管理），请参阅 MCP 服务器参考。

选项

serve 命令支持所有配置选项。以下是最常用的选项：

配置选项

• --config, -c <path> - 指定配置文件路径
• --config-dir, -d <path> - 配置目录路径

传输选项

• --transport, -t <type> - 选择传输类型（stdio、http）
• --port, -P <port> - 更改 HTTP 端口（默认：3050）
• --host, -H <host> - 更改 HTTP 主机（默认：localhost）

安全选项

• --enable-auth - 启用 OAuth 2.1 身份验证
• --enable-enhanced-security - 启用增强安全中间件
• --trust-proxy <config> - 信任代理配置

过滤选项

• --tag-filter, -f <expression> - 高级标签过滤表达式
• --tags, -g <tags> - ⚠️ 已弃用 - 请使用 --tag-filter

日志选项

• --log-level <level> - 设置日志级别（debug、info、warn、error）
• --log-file <path> - 将日志写入文件

所有选项请参见 配置深入指南。

示例

基本用法

# 使用默认设置启动（HTTP 在 localhost:3050）
npx -y @1mcp/agent serve

# 在自定义端口上启动
npx -y @1mcp/agent serve --port=3052

# 使用 stdio 传输启动
npx -y @1mcp/agent serve --transport=stdio

自定义配置

# 使用自定义配置文件
npx -y @1mcp/agent serve --config=/path/to/config.json

# 使用调试日志记录启动
npx -y @1mcp/agent serve --log-level=debug

生产部署

# 带有身份验证的生产 HTTP 服务器
npx -y @1mcp/agent serve \
  --host=0.0.0.0 \
  --port=3051 \
  --enable-auth \
  --enable-enhanced-security \
  --trust-proxy=true

# 使用外部 URL 进行 OAuth 重定向
npx -y @1mcp/agent serve \
  --external-url=https://mcp.yourdomain.com \
  --enable-auth

开发

# 使用调试日志和完整健康信息进行开发
npx -y @1mcp/agent serve \
  --log-level=debug \
  --health-info-level=full \
  --enable-async-loading

# 使用自定义配置目录进行开发
npx -y @1mcp/agent serve \
  --config-dir=./dev-config \
  --log-level=debug

标签过滤

# 简单标签过滤（OR 逻辑）- ⚠️ 已弃用
npx -y @1mcp/agent serve --transport=stdio --tags="network,filesystem"

# 高级标签过滤（布尔表达式）- 推荐
npx -y @1mcp/agent serve --transport=stdio --tag-filter="network+api"
npx -y @1mcp/agent serve --transport=stdio --tag-filter="(web,api)+prod-test"
npx -y @1mcp/agent serve --transport=stdio --tag-filter="web and api and not test"

注意： --tags 参数已弃用。请使用 --tag-filter 进行简单和高级过滤。

另请参阅

• 配置深入指南 - CLI 标志和环境变量
• MCP 服务器参考 - 后端服务器配置
• 安全指南 - 安全最佳实践
• 健康检查 API 参考 - 监控端点