z-tool

功能与工具

CMDB

| 工具 | 说明 | | --- | --- | | cmdb_list_deploy_clusters | 查询当前账号可选发布集群的 ID、名称和环境标识 | | cmdb_query_nginx_config | 查询 Nginx 环境、域名列表和配置正文 | | cmdb_get_service_pods | 查询服务的 Pod 部署状态 | | cmdb_get_pod_logs | 查询 Pod 应用日志并在本地提取异常 | | cmdb_restart_services | 滚动重启一个或多个服务 | | cmdb_preview_deploy | 预览指定服务的发布内容 | | cmdb_create_deploy_apply | 创建发布单但不执行 | | cmdb_run_deploy_apply | 执行已有发布单 | | cmdb_run_deploy | 创建并执行发布单 | | cmdb_get_deploy_status | 查询发布单和任务状态 |

发布、重启和 Pod 查询支持 cluster_id 或 env 精确集群名称/环境标识；两者互斥，均省略时默认 dev。保留 dev、xn-dev 别名，其他目标通过 cmdb_list_deploy_clusters 查询，无需维护固定环境列表。列表按账号隔离并在本地缓存 5 分钟，force_refresh: true 可强制刷新；操作前重新校验当前账号可选集群，最终权限由 CMDB 校验。

Elasticsearch

| 工具 | 说明 | | --- | --- | | es_resolve_indices | 按通配符解析索引 | | es_get_index_info | 查看索引映射和设置 | | es_search_documents | 查询索引文档 | | es_write_documents | 按 ID 写入或删除文档 | | es_write_by_query | 按条件批量写入或删除 |

Redis

| 工具 | 说明 | | --- | --- | | redis_scan_keys | 用 SCAN 扫描 key 并查看类型和 TTL | | redis_get_values | 按精确 key 批量读值 | | redis_write_keys | 设置、删除 key 或调整 TTL | | redis_server_info | 查看实例状态与 key 总量 |

Kibana

| 工具 | 说明 | | --- | --- | | kibana_resolve_indices | 通过 Kibana 解析日志索引 | | kibana_search_logs | 搜索或统计应用日志 |

Jenkins

| 工具 | 说明 | | --- | --- | | jenkins_list_jobs | 查询 Jenkins 任务列表 | | jenkins_find_job_by_service | 按服务定位构建任务 | | jenkins_trigger_branch_build | 触发分支构建 | | jenkins_get_build_status | 查询构建状态 |

Apollo

| 工具 | 说明 | | --- | --- | | apollo_get_item | 查询单个配置项 | | apollo_preview_change | 预览配置变更 | | apollo_create_items | 新增配置项但不发布 | | apollo_update_items | 更新或创建配置项但不发布 | | apollo_publish_namespace | 发布指定命名空间 |

XXL-JOB

| 工具 | 说明 | | --- | --- | | xxl_job_list_groups | 查询执行器列表 | | xxl_job_list_jobs | 查询或筛选任务 | | xxl_job_get_job | 定位单个任务 | | xxl_job_list_logs | 查询任务调度日志 | | xxl_job_get_log_detail | 读取任务执行日志片段 | | xxl_job_preview_change | 预览任务创建或修改 | | xxl_job_apply_change | 创建或修改任务 | | xxl_job_action | 删除、启停或触发任务 |

Nacos

| 工具 | 说明 | | --- | --- | | nacos_list_namespaces | 查询命名空间列表 | | nacos_get_config | 查询单个配置 | | nacos_list_configs | 查询配置列表 | | nacos_list_services | 查询服务列表 | | nacos_get_service | 查询单个服务 | | nacos_list_instances | 查询服务实例 |

RocketMQ

| 工具 | 说明 | | --- | --- | | rocketmq_inspect_subscription | 诊断 Topic、消费组、在线客户端、订阅关系与 Broker 策略 | | rocketmq_preview_subscription_change | 预览确保 Topic 和消费组存在所需的变更 | | rocketmq_apply_subscription_change | 仅在 dev 创建或更新 Topic 与消费组 |

MCP Endpoint

• MCP: http://127.0.0.1:9010/mcp
• Health: http://127.0.0.1:9010/health

Codex MCP Config

[mcp_servers.z-tool]
type = "streamable-http"
url = "http://127.0.0.1:9010/mcp"
tool_timeout_sec = 300