命令参考

1MCP Agent 提供了一个全面的命令行界面，用于管理 MCP 服务器和桌面应用程序配置。

快速参考

主要命令

• serve - 启动 1MCP 服务器 (默认命令)
• app - 管理桌面应用程序 MCP 配置
• mcp - 管理 MCP 服务器配置

全局选项

• --help, -h - 显示帮助信息
• --version - 显示版本信息
• --config, -c <path> - 指定配置文件路径
• --transport, -t <type> - 传输类型 (stdio, http, sse)
• --port, -P <port> - HTTP 端口 (默认: 3051)
• --host, -H <host> - HTTP 主机 (默认: localhost)

命令组

应用命令

管理桌面应用程序 MCP 配置。将来自各种桌面应用程序的 MCP 服务器整合到 1MCP 中。

npx -y @1mcp/agent app consolidate claude-desktop    # 整合 Claude Desktop 服务器
npx -y @1mcp/agent app restore claude-desktop        # 恢复原始配置
npx -y @1mcp/agent app list                          # 列出支持的应用程序

MCP 命令

在您的 1MCP 实例中管理 MCP 服务器配置。

npx -y @1mcp/agent mcp add myserver --type=stdio --command=node --args=server.js
npx -y @1mcp/agent mcp list                       # 列出已配置的服务器
npx -y @1mcp/agent mcp status                     # 检查服务器状态

Serve 命令

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

npx -y @1mcp/agent serve                            # 使用默认设置启动
npx -y @1mcp/agent serve --port=3052                # 在自定义端口上启动
npx -y @1mcp/agent serve --transport=stdio          # 使用 stdio 传输

入门

如果您是 1MCP Agent 的新手，请从以下内容开始：

1. 安装指南 - 安装 1MCP Agent
2. 快速入门 - 基本设置和第一个服务器
3. 应用命令 - 整合现有的 MCP 配置
4. MCP 命令 - 添加和管理 MCP 服务器

示例

基本用法

# 启动 1MCP 服务器
npx -y @1mcp/agent serve

# 添加一个新的 MCP 服务器
npx -y @1mcp/agent mcp add filesystem --type=stdio --command=mcp-server-filesystem

# 整合 Claude Desktop 配置
npx -y @1mcp/agent app consolidate claude-desktop

# 检查状态
npx -y @1mcp/agent mcp status

高级用法

# 使用自定义配置启动
npx -y @1mcp/agent serve --config=/custom/path/config.json --port=3052

# 添加基于 HTTP 的 MCP 服务器
npx -y @1mcp/agent mcp add remote-api --type=http --url=https://api.example.com/mcp

# 批量整合多个应用程序
npx -y @1mcp/agent app consolidate claude-desktop cursor vscode --yes

# 按标签过滤服务器
npx -y @1mcp/agent mcp list --tags=prod,api --verbose

环境变量

所有命令行选项也可以通过带有 ONE_MCP_ 前缀的环境变量来设置：

export ONE_MCP_PORT=3052
export ONE_MCP_HOST=0.0.0.0
export ONE_MCP_CONFIG_PATH=/custom/config.json

配置文件

1MCP Agent 使用 JSON 配置文件来存储服务器定义和设置。有关配置文件格式和选项的详细信息，请参阅配置指南。