preset show
显示特定预设的详细信息。
有关预设管理的完整概述，请参阅 预设命令概述。
概要
bash
npx -y @1mcp/agent preset show <name>参数
<name>- 要显示详细信息的预设名称。
- 必需：是
全局选项
此命令支持所有全局选项：
--config, -c <path>- 指定配置文件路径--config-dir, -d <path>- 配置目录路径
描述
preset show 命令在单个、有组织的显示中提供特定预设的全面信息。这通过显示完整的细节而不截断来补充紧凑的 preset list 表格。
显示的信息
- 基本信息：名称、策略、描述、创建日期
- 客户端 URL：用于 MCP 客户端配置的即用型 URL
- 标签查询：具有适当格式的完整 JSON 查询（无截断）
- 服务器匹配：哪些服务器匹配预设条件
- 快速操作：与预设相关的常见命令
示例
基本用法
bash
# 显示特定预设的详细信息
npx -y @1mcp/agent preset show development
# 显示生产预设信息
npx -y @1mcp/agent preset show production示例输出
┌─────────── Preset Details ────────────┐
│ 📋 development │
│ Strategy: OR logic - Match ANY tags │
│ Description: Development servers │
│ Created: 9/6/2025 │
│ │
│ Client URL: │
│ http://127.0.0.1:3050/?preset=dev │
│ │
│ Tag Query: │
│ { │
│ "$or": [ │
│ { "tag": "web" }, │
│ { "tag": "api" } │
│ ] │
│ } │
│ │
│ Matching Servers (2): │
│ • webserver, • apiserver │
│ │
│ Quick Actions: │
│ • Test: preset test development │
│ • Edit: 1mcp preset edit dev │
│ • URL: preset url development │
└───────────────────────────────────────┘信息部分
基本信息
- 名称：预设标识符
- 策略：人类可读的策略描述
- 描述：可选的用户提供的描述
- 创建：预设首次创建的时间
客户端 URL
用于配置 MCP 客户端的生成 URL：
- 格式：
http://host:port/?preset=name - 用法：将此 URL 复制到您的 MCP 客户端配置中
- 动态：自动解析到适当的服务器子集
标签查询
过滤条件的完整 JSON 表示：
- 无截断：完整查询显示，格式正确
- 语法高亮：JSON 结构清晰格式化
- 策略映射：显示您的选择如何转换为查询
服务器匹配
将预设应用于当前配置的实时结果：
- 匹配计数：匹配条件的服务器数量
- 服务器列表：匹配服务器的名称（或"没有服务器匹配"）
- 实时结果：基于您当前的服务器配置
快速操作
与此预设相关的便捷命令：
- 测试：
preset test <name>- 验证服务器匹配 - 编辑：
1mcp preset edit <name>- 修改预设 - URL：
preset url <name>- 仅获取客户端 URL
用例
开发工作流程
bash
# 在使用前审查预设
npx -y @1mcp/agent preset show development
# 将客户端 URL 复制到您的 MCP 客户端配置中
# 使用匹配服务器信息验证包含正确的服务器团队协作
bash
# 与团队成员共享预设详细信息
npx -y @1mcp/agent preset show team-production
# 团队成员可以看到确切的配置和匹配的服务器故障排除
bash
# 调试预设为什么不按预期工作
npx -y @1mcp/agent preset show problematic-preset
# 检查标签查询部分的语法问题
# 查看匹配服务器以查看实际结果错误处理
预设未找到
bash
npx -y @1mcp/agent preset show nonexistent
# Error: Preset 'nonexistent' not found无效预设
如果预设存在但有验证问题，命令会在匹配服务器部分显示错误详细信息。
工作流程集成
常见用法模式：
bash
# 1. 列出预设以查看可用选项
npx -y @1mcp/agent preset list
# 2. 显示特定预设的详细信息
npx -y @1mcp/agent preset show staging
# 3. 如果需要测试预设
npx -y @1mcp/agent preset test staging
# 4. 在您的 MCP 客户端中使用客户端 URL另请参阅
- preset list - 表格格式的所有预设概览
- preset test - 测试预设服务器匹配，包含其他详细信息
- preset url - 仅获取预设的客户端 URL
- 智能交互模式 - 自动检测现有预设并提供编辑选项