preset test
针对您当前的服务器配置测试预设。
有关预设管理的完整概述,请参阅 预设命令概述。
概要
bash
1mcp preset test <name>参数
<name>- 要测试的预设名称。
- 必需:是
全局选项
--config, -c <路径>- 指定配置文件路径--config-dir, -d <路径>- 指定配置目录
描述
preset test 命令针对您当前的服务器配置验证预设,显示哪些服务器匹配预设的过滤条件。这对于在客户端配置中使用预设之前验证它们按预期工作至关重要。
测试内容
- 服务器匹配:哪些服务器匹配预设的标签查询
- 查询验证:预设的标签查询在语法上是否正确
- 标签可用性:当前服务器配置中有哪些标签可用
- 配置一致性:预设中引用的服务器是否仍然存在
示例
基本用法
bash
# 测试开发预设
1mcp preset test development
# 测试生产预设
1mcp preset test production示例输出
bash
1mcp preset test development
🔍 Testing preset 'development':
Matching servers: webserver, apiserver, devtools
Available tags: web, api, database, development, testing, monitoring没有匹配的服务器
bash
1mcp preset test strict-production
🔍 Testing preset 'strict-production':
Matching servers: none
Available tags: web, api, development, testing
⚠️ No servers match this preset's criteria.
Consider updating the preset or adding appropriate server tags.输出信息
匹配服务器
- 服务器列表:匹配预设条件的服务器名称
- 计数:匹配服务器的总数
- 空结果:如果没有服务器匹配,则明确指示
可用标签
- 当前标签:在您的服务器配置中找到的所有标签
- 标签计数:唯一标签的总数
- 覆盖范围:帮助了解哪些标签可用于过滤
验证状态
- 成功:预设查询有效并找到匹配的服务器
- 警告:预设有效但找不到匹配的服务器
- 错误:预设查询有语法错误或引用不存在的标签
用例
预设验证
bash
# 验证新创建的预设工作正常
1mcp preset create team-dev --filter "web,api,development"
1mcp preset test team-dev故障排除
bash
# 调试预设为什么不按预期工作
1mcp preset test problematic-preset
# 与可用标签比较以识别问题服务器配置更改
bash
# 添加或修改服务器后,测试现有预设
1mcp preset test development
1mcp preset test production
# 确保预设仍然匹配预期的服务器部署前验证
部署配置变更前,先运行 1mcp preset list,再对每个已配置的预设执行 1mcp preset test <name>。以下名称仅为示例,请替换为实际的预设名称。
bash
# 列出已配置的预设
1mcp preset list
# 测试示例;请对每个已配置的预设重复执行
1mcp preset test development
1mcp preset test production与开发工作流程的集成
服务器更改后
请将 /absolute/path/server.js 替换为实际服务器脚本的路径。
bash
# 1. 修改服务器配置(添加/删除服务器或标签)
1mcp mcp add newserver --type=stdio --tags=web,api -- node /absolute/path/server.js
# 2. 测试现有预设以查看影响
1mcp preset test web-services
# 3. 根据需要更新预设
1mcp preset edit web-services客户端配置前
bash
# 1. 测试预设以确保它匹配预期的服务器
1mcp preset test production
# 2. 为客户端配置生成 URL
1mcp preset url production
# 3. 使用验证的预设 URL 配置客户端错误处理
预设未找到
bash
1mcp preset test nonexistent
# Error: Preset 'nonexistent' not found无效查询语法
如果预设的标签查询中有语法错误:
bash
1mcp preset test broken-preset
# Error: Invalid tag query syntax in preset 'broken-preset': unexpected token服务器配置问题
如果服务器配置有问题:
bash
1mcp preset test development
# Warning: Some servers in configuration have validation errors
# Matching servers: webserver (2 servers skipped due to errors)性能考虑
- 快速执行:针对当前配置在内存中执行测试
- 无服务器启动:测试查询验证而不启动实际服务器
- 批量测试:可以快速在多个预设上运行以进行验证
验证级别
查询语法
- 有效 JSON:标签查询必须是语法正确的 JSON
- 支持的运算符:必须使用支持的查询运算符(
$and、$or、tag) - 类型安全:标签值必须是字符串
服务器匹配
- 标签存在:引用的标签必须存在于服务器配置中
- 服务器可用性:服务器必须正确配置
- 过滤逻辑:查询逻辑必须产生一致的结果
另请参阅
preset edit - 使用交互式界面修改预设
preset show - 显示详细的预设信息,包括服务器匹配
preset create - 创建具有特定标签条件的预设
智能交互模式 - 根据测试结果交互式修改预设
mcp status - 检查整体服务器配置健康状况
