跳转到内容

preset list

以格式化表格显示所有可用的预设。

有关预设管理的完整概述,请参阅 预设命令概述

概要

bash
npx -y @1mcp/agent preset list

全局选项

此命令支持所有全局选项:

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

描述

preset list 命令以紧凑、有组织的表格格式显示所有配置的预设。这提供了预设配置的快速概览,包括名称、策略、查询摘要和使用信息。

输出格式

命令显示:

  • 标题:找到的预设总数
  • 表格:包含预设信息的组织列
  • 快速参考:预设管理的可用命令

表格列

  • 名称:预设标识符(如果超过 16 个字符则截断)
  • 策略:过滤方法(OR 逻辑、AND 逻辑、Advanced)
  • 查询:标签查询摘要(如果超过 33 个字符则截断)

示例

基本用法

bash
# 列出所有预设
npx -y @1mcp/agent preset list

示例输出

┌─────────────── Preset Manager ──────────────┐
│   📋 Available Presets                      │
│   Found 3 presets in your configuration     │
└─────────────────────────────────────────────┘

┌─────────────────────────────────────────────┐
│  Name              Strategy   Query                               │
│  ────────────────  ─────────  ──────────────────────────────────  │
│  dev              OR logic   {"$or":[...                        │
│  production       Advanced  {"$and":[...                       │
│  staging          OR logic   {"tag":"staging"}                 │
└─────────────────────────────────────────────────────────────────────────────┘

┌──────────── Quick Reference ─────────────┐
│  Available Commands:                     │
│                                          │
│  • preset show <name>    Show details   │
│  • preset url <name>     Generate URL   │
│  • preset test <name>    Test preset    │
│  • preset delete <name>  Delete preset  │
└──────────────────────────────────────────┘

理解输出

空配置

如果不存在预设,命令会显示有用的指导:

┌──── No Presets Available ─────┐
│   ⚠️  No presets found        │
└───────────────────────────────┘

Create your first preset with:
  preset create <name> --filter "web,api"
  1mcp preset

策略类型

  • OR 逻辑:匹配具有任何选定标签的服务器
  • AND 逻辑:匹配具有所有选定标签的服务器
  • Advanced:使用自定义 JSON 查询进行复杂过滤

查询截断

长查询会截断为 "..." 以保持表格格式。使用 preset show <name> 查看完整查询。

工作流程集成

list 命令与其他预设命令配合良好:

bash
# 1. 列出所有预设以查看可用的选项
npx -y @1mcp/agent preset list

# 2. 显示特定预设的详细信息
npx -y @1mcp/agent preset show production

# 3. 测试预设以查看匹配的服务器
npx -y @1mcp/agent preset test production

# 4. 为客户端配置生成 URL
npx -y @1mcp/agent preset url production

使用技巧

  • 定期审查:使用 preset list 定期审查您的预设配置
  • 清理旧预设:查找不需要的预设
  • 快速扫描:表格格式使比较策略和识别预设变得容易
  • 跟进详细信息:需要完整信息时使用 preset show <name>

另请参阅

基于 Apache 2.0 许可发布