跳转到内容

管理工具

管理工具提供对 MCP 服务器的全面运营控制,包括状态管理、配置编辑、健康监控和性能优化。这些工具专注于为 AI 助手提供细粒度的控制权和实时可见性。

工具概述

mcp_enable

启用已禁用的 MCP 服务器,支持选择性功能激活和依赖验证。确保服务器在启用前满足所有运行要求。

mcp_disable

优雅地禁用 MCP 服务器,支持连接排空和状态保存。可选择临时禁用或完全停止服务。

mcp_list

列出所有配置的 MCP 服务器,支持按状态、标签和功能进行过滤。提供详细的运行时信息和配置概览。

mcp_status

获取特定服务器的详细状态信息,包括健康指标、性能统计和诊断信息。支持历史状态跟踪和趋势分析。

mcp_reload

重新加载服务器配置或重启服务器,支持热重载和零停机更新。包含回滚机制和配置验证。

mcp_edit

编辑 MCP 服务器配置,提供实时验证、模式检查和语法高亮。支持配置模板和批量更新。

使用模式

服务器生命周期管理

AI 助手通过简单的工具调用管理服务器状态:

  • 使用 mcp_enable 激活已禁用的服务器并进行验证
  • 使用 mcp_disable 优雅地关闭服务器并进行连接排空
  • 使用 mcp_status 在操作前后验证服务器状态
  • 使用 mcp_list 发现服务器并按状态或标签过滤

配置管理

AI 助手通过以下方式管理配置:

  • 使用 mcp_edit 进行配置更改并进行验证
  • 使用 mcp_reload 应用配置更新
  • 使用 mcp_edit 内置的备份和回滚功能
  • 支持零停机更新的热重载功能

健康监控

AI 助手通过以下方式监控服务器健康:

  • 使用带有指标和诊断选项的 mcp_status
  • 通过 mcp_list 后跟状态检查监控多个服务器
  • 分析性能趋势和资源使用情况
  • 识别并响应健康问题

AI 助手使用场景

服务器健康监控

AI 助手可以通过定期检查所有服务器的状态、识别不健康或不活动的服务器、并报告需要注意的问题来维护服务器健康。

配置管理

AI 助手可以通过对服务器组应用标准配置、在应用前验证更改、以及使用备份功能进行安全修改来自动化配置任务。

故障排除

AI 助手可以通过收集状态和诊断信息、分析高资源使用率或错误率等常见问题、并提供可行的建议来诊断服务器问题。

工具交互

管理工具可以有效地按顺序工作:

  • 状态管理mcp_listmcp_statusmcp_enable/disable
  • 配置更新mcp_statusmcp_editmcp_reload
  • 健康监控:带有指标的 mcp_status 用于持续监控
  • 定向操作:带过滤的 mcp_list 用于特定服务器组

AI 助手最佳实践

  1. 在更改前验证先决条件
  2. 使用状态检查 确认操作成功
  3. 优雅地处理错误 并提供清晰反馈
  4. 在操作前后监控服务器健康
  5. 使用 mcp_edit 选项创建备份
  6. 高效使用批量操作 进行多服务器管理
  7. 实现重试逻辑 处理临时故障
  8. 在应用更改前验证配置

另请参阅

基于 Apache 2.0 许可发布