diff --git a/docs/zh/openeuler_intelligence/oe_cli/oe_cli_agent_introduce.md b/docs/zh/openeuler_intelligence/oe_cli/oe_cli_agent_introduce.md
index 584bbdd9c209984aa4a0a3b44995b511b8653ba2..ddc14ac4d3b0e8230381fdce16bda4cd22e48080 100644
--- a/docs/zh/openeuler_intelligence/oe_cli/oe_cli_agent_introduce.md
+++ b/docs/zh/openeuler_intelligence/oe_cli/oe_cli_agent_introduce.md
@@ -1,6 +1,6 @@
-# openEuler Intelligence智能体使用手册
+# openEuler Intelligence 智能体使用手册
-## 1.引言
+## 1. 引言
本手册介绍的 OE 智能体系列,是 **openEuler Intelligence 生态的核心工具集**,专为基于 openEuler 开展开发、运维工作,或负责 openEuler 系统管理的用户设计,覆盖物理机、虚拟机、容器集群等主流部署形态,无需依赖第三方工具即可在 openEuler 生态内完成全流程操作。
@@ -20,75 +20,75 @@
### 默认智能体总汇表
-| Agent 名称 | 核心适用场景 | 核心能力模块 |
-|------------------------------|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [**OE-智能运维助手**](#OE-智能运维助手) | 全场景通用系统运维(日常监控、基础操作、网络管理) | 1. 网络状态监控(流量统计、连接排查、带宽分析)与防火墙规则管控(端口访问、安全策略配置)
2. 系统性能分析(CPU/内存/进程负载监控)与硬件信息查询(节点配置、硬件型号采集)
3. 存储管理(内存/Swap 管控、磁盘数据同步)与文件操作(内容编辑、跨节点传输、批量管理) |
-| [**OE-智算调优助手**](#OE-智算调优助手) | AI/GPU/NPU 异构智算场景(模型训练、异构硬件监控) | 1. 异构硬件状态监控(GPU 负载/显存/温度、NPU 算力/内存占用实时采集)
2. 智算任务系统追踪(运行轨迹、资源消耗统计)与问题排查(显存溢出、进程异常定位)
3. 基础运维支持(后台任务启动、日志跟踪、配置文件编辑、跨节点数据传输)
4.AI 训练任务性能分析与优化建议(基于全栈跟踪数据,识别 Host bound、算子慢、CPU 抢占等性能瓶颈,提供针对性调优方向,降低故障导致的训练成本浪费) |
-| [**OE-通算调优助手**](#OE-通算调优助手) | 通用计算场景(NUMA 架构优化、性能瓶颈诊断) | 1. NUMA 架构分析(节点拓扑、CPU/内存关联)与进程绑定优化(启动绑定、动态调整、容器 NUMA 管控)
2. CPU 热点追踪(高频函数定位)、缓存损耗诊断(L1/L2/L3 缓存未命中率分析)与系统调用排查(I/O 瓶颈、中断影响)
3. 系统性能指标采集(CPU/内存/IOPS 周期性记录)与调优效果验证(性能基线对比、优化方案生成)
4.智能参数调优与效果验证(基于系统、微架构、应用等多维度指标采集,借助大语言模型与定制化 Prompt 工程生成应用可调参数推荐,通过 benchmark 运行对比基线数据,量化性能提升值,实现调优方案的精准落地) |
-| [**OE-容器镜像助手**](#OE-容器镜像助手) | 容器与虚拟化环境管理(Docker 运维、QEMU 管理) | 1. Docker 容器生命周期管理(创建/启动/停止/删除)与镜像运维(导出/导入、跨节点迁移)
2. QEMU 虚拟化环境管控(虚拟机创建、资源配置、网络模式设置、运行状态监控)
3. 容器 NUMA 绑定优化(内存访问模式分析、跨节点损耗降低、性能提升配置) |
+| Agent 名称 | 核心适用场景 | 核心能力模块 |
+|------------|--------------|--------------|
+| [**OE-智能运维助手**](#OE-智能运维助手) | 全场景通用系统运维(日常监控、基础操作、网络管理) | 1. 网络状态监控(流量统计、连接排查、带宽分析)与防火墙规则管控(端口访问、安全策略配置)
2. 系统性能分析(CPU/内存/进程负载监控)与硬件信息查询(节点配置、硬件型号采集)
3. 存储管理(内存/Swap 管控、磁盘数据同步)与文件操作(内容编辑、跨节点传输、批量管理) |
+| [**OE-智算调优助手**](#OE-智算调优助手) | AI/GPU/NPU 异构智算场景(模型训练、异构硬件监控) | 1. 异构硬件状态监控(GPU 负载/显存/温度、NPU 算力/内存占用实时采集)
2. 智算任务系统追踪(运行轨迹、资源消耗统计)与问题排查(显存溢出、进程异常定位)
3. 基础运维支持(后台任务启动、日志跟踪、配置文件编辑、跨节点数据传输)
4. AI 训练任务性能分析与优化建议(基于全栈跟踪数据,识别 Host bound、算子慢、CPU 抢占等性能瓶颈,提供针对性调优方向,降低故障导致的训练成本浪费) |
+| [**OE-通算调优助手**](#OE-通算调优助手) | 通用计算场景(NUMA 架构优化、性能瓶颈诊断) | 1. NUMA 架构分析(节点拓扑、CPU/内存关联)与进程绑定优化(启动绑定、动态调整、容器 NUMA 管控)
2. CPU 热点追踪(高频函数定位)、缓存损耗诊断(L1/L2/L3 缓存未命中率分析)与系统调用排查(I/O 瓶颈、中断影响)
3. 系统性能指标采集(CPU/内存/IOPS 周期性记录)与调优效果验证(性能基线对比、优化方案生成)
4. 智能参数调优与效果验证(基于系统、微架构、应用等多维度指标采集,借助大语言模型与定制化 Prompt 工程生成应用可调参数推荐,通过 benchmark 运行对比基线数据,量化性能提升值,实现调优方案的精准落地) |
+| [**OE-容器镜像助手**](#OE-容器镜像助手) | 容器与虚拟化环境管理(Docker 运维、QEMU 管理) | 1. Docker 容器生命周期管理(创建/启动/停止/删除)与镜像运维(导出/导入、跨节点迁移)
2. QEMU 虚拟化环境管控(虚拟机创建、资源配置、网络模式设置、运行状态监控)
3. 容器 NUMA 绑定优化(内存访问模式分析、跨节点损耗降低、性能提升配置) |
-**说明:**
-
-1. **关键 MCP 工具**:聚焦各 Agent 差异化能力,仅该场景需依赖的工具,是选择 Agent 的核心判断依据;
-2. **基础通用工具**:覆盖日常运维高频操作,所有 Agent 均集成,确保无需跨 Agent 即可完成基础操作;
-3. **场景匹配建议**:日常网络/硬件监控选「OE-智能运维助手」,AI 异构计算选「OE-智算调优助手」,NUMA 架构优化选「OE-通算调优助手」,容器/虚拟化管理选「OE-容器镜像助手」。
+> [!NOTE] 说明
+>
+> 1. **关键 MCP 工具**:聚焦各 Agent 差异化能力,仅该场景需依赖的工具,是选择 Agent 的核心判断依据;
+> 2. **基础通用工具**:覆盖日常运维高频操作,所有 Agent 均集成,确保无需跨 Agent 即可完成基础操作;
+> 3. **场景匹配建议**:日常网络/硬件监控选「OE-智能运维助手」,AI 异构计算选「OE-智算调优助手」,NUMA 架构优化选「OE-通算调优助手」,容器/虚拟化管理选「OE-容器镜像助手」。
## 2. OE-智能运维助手
-OE-智能运维助手是 openEuler Intelligence 体系下的**全场景通用运维智能体**,聚焦企业级服务器日常运维的“监控-排查-处理-管理”全流程需求,整合42个标准化MCP工具(覆盖网络、进程、硬件、存储、文件等核心维度),实现“单智能体替代多工具切换”的高效运维模式。
+OE-智能运维助手是 openEuler Intelligence 体系下的**全场景通用运维智能体**,聚焦企业级服务器日常运维的“监控-排查-处理-管理”全流程需求,整合 42 个标准化 MCP 工具(覆盖网络、进程、硬件、存储、文件等核心维度),实现“单智能体替代多工具切换”的高效运维模式。
-其核心优势在于**低门槛、全闭环、跨环境适配**:支持自然语言与标准化指令双交互,新手运维无需记忆复杂命令即可完成操作;从“异常发现(如CPU高负载、网络卡顿)”到“问题定位(如进程追踪、流量分析)”再到“故障处理(如进程终止、配置修改)”,无需跨模块即可完成闭环;兼容物理机、虚拟机、云服务器等多种部署环境,是企业日常运维的“一站式工具中枢”。
+其核心优势在于**低门槛、全闭环、跨环境适配**:支持自然语言与标准化指令双交互,新手运维无需记忆复杂命令即可完成操作;从“异常发现(如 CPU 高负载、网络卡顿)”到“问题定位(如进程追踪、流量分析)”再到“故障处理(如进程终止、配置修改)”,无需跨模块即可完成闭环;兼容物理机、虚拟机、云服务器等多种部署环境,是企业日常运维的“一站式工具中枢”。
### 2.1 MCP 服务矩阵
-OE-智能运维助手通过42个标准化MCP工具,构建“基础信息与命令执行-进程与系统监控-网络监控与安全-硬件与存储管理-文件与文本操作”五大核心能力模块,覆盖日常运维95%以上高频场景,具体服务与工具映射如下:
-
-| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
-|------------------------|-----------------------------|------------------------------------------------|-----------|
-| 一、基础信息与命令执行 | [remote_info_mcp](#remote_info_mcp) | 获取本地/远程节点基础信息(系统版本、硬件型号) | 12100 |
-| | [shell_generator_mcp](#shell_generator_mcp) | 生成并执行 Shell 命令,支撑自然语言指令解析 | 12101 |
-| 二、进程与系统监控 | [kill_mcp](#kill_mcp) | 终止进程、查看进程信号量含义,处理异常进程 | 12111 |
-| | [nohup_mcp](#nohup_mcp) | 后台启动进程,避免终端退出导致进程中断 | 12112 |
-| | [strace_mcp](#strace_mcp) | 跟踪进程系统调用,分析异常进程的行为逻辑 | 12113 |
-| | [top_mcp](#top_mcp) | 查看 CPU/内存/进程负载,识别高占用资源进程 | 12110 |
-| | [perf_interrupt_mcp](#perf_interrupt_mcp) | 定位高频中断源,分析中断导致的 CPU 占用 | 12220 |
-| | [flame_graph_mcp](#flame_graph_mcp) | 生成 CPU 耗时火焰图,可视化函数调用栈瓶颈 | 12222 |
-| 三、网络监控与安全 | [iftop_mcp](#iftop_mcp) | 实时监控指定网卡流量,按连接/主机统计带宽占用 | 12116 |
-| | [nload_mcp](#nload_mcp) | 可视化展示网卡入/出带宽变化,识别带宽瓶颈 | 12117 |
-| | [netstat_mcp](#netstat_mcp) | 查看网络连接状态、端口占用、协议统计,排查连接异常 | 12118 |
-| | [lsof_mcp](#lsof_mcp) | 定位文件占用冲突、网络连接对应的进程,解决资源争抢 | 12119 |
-| | [ifconfig_mcp](#ifconfig_mcp)| 查看/配置网络接口 IP、MAC 地址,诊断网卡基础问题 | 12120 |
-| | [ethtool_mcp](#ethtool_mcp) | 查询网卡特性(速率/双工模式),配置网卡参数 | 12121 |
-| | [tshark_mcp](#tshark_mcp) | 捕获网络数据包,分析协议异常(如丢包、延迟) | 12122 |
-| | [firewalld_mcp](#firewalld_mcp) | 配置防火墙规则、Zone,管控端口访问权限 | 12130 |
-| | [iptables_mcp](#iptables_mcp) | 配置 iptables 包过滤与 NAT 规则,强化网络安全 | 12131 |
-| | [nmap_mcp](#nmap_mcp) | 扫描目标 IP 存活状态、开放端口,排查网络可达性 | 12135 |
-| 四、硬件与存储管理 | [lscpu_mcp](#lscpu_mcp) | 采集 CPU 架构、核心数、NUMA 节点等静态信息 | 12202 |
-| | [free_mcp](#free_mcp) | 查看系统内存、Swap 整体使用状态,识别内存不足 | 13100 |
-| | [sync_mcp](#sync_mcp) | 将内存缓冲区数据强制写入磁盘,避免数据丢失 | 13103 |
-| | [swapon_mcp](#swapon_mcp) | 启用 Swap 设备/文件,扩展虚拟内存 | 13104 |
-| | [swapoff_mcp](#swapoff_mcp) | 停用 Swap 设备/文件,释放磁盘资源 | 13105 |
-| | [fallocate_mcp](#fallocate_mcp) | 快速创建指定大小的 Swap 文件,应急扩展内存 | 13106 |
-| 五、文件与文本操作 | [file_content_tool_mcp](#file_content_tool_mcp) | 对文件内容进行增、删、改、查,处理文本类需求 | 12125 |
-| | [file_transfer_mcp](#file_transfer_mcp) | 本地与远程节点间文件传输、下载,支持批量操作 | 12136 |
-| | [find_mcp](#find_mcp) | 按名称/大小/修改时间等条件查找文件 | 13107 |
-| | [touch_mcp](#touch_mcp) | 创建空文件、修改文件访问/修改时间 | 13108 |
-| | [mkdir_mcp](#mkdir_mcp) | 创建单个/多级文件夹,支持权限设置 | 13109 |
-| | [rm_mcp](#rm_mcp) | 删除文件/文件夹,支持强制删除 | 13110 |
-| | [mv_mcp](#mv_mcp) | 移动文件到指定路径,或修改文件名称 | 13111 |
-| | [ls_mcp](#ls_mcp) | 查看目录下文件/文件夹名称、权限、大小 | 13112 |
-| | [head_mcp](#head_mcp) | 查看文件前 N 行内容(默认前 10 行) | 13113 |
-| | [tail_mcp](#tail_mcp) | 查看文件后 N 行内容,支持实时跟踪(-f) | 13114 |
-| | [cat_mcp](#cat_mcp) | 查看文件全部内容,支持多文件合并查看 | 13115 |
-| | [chmod_mcp](#chmod_mcp) | 修改文件/文件夹的读、写、执行权限 | 13117 |
-| | [chown_mcp](#chown_mcp) | 修改文件/文件夹的所有者(用户/用户组) | 13116 |
-| | [tar_mcp](#tar_mcp) | 打包/解包文件,支持 gzip/bzip2 压缩 | 13118 |
-| | [zip_mcp](#zip_mcp) | 压缩/解压 zip 格式文件,支持密码保护 | 13119 |
-| | [grep_mcp](#grep_mcp) | 按关键词搜索文件内容,支持正则匹配 | 13120 |
-| | [sed_mcp](#sed_mcp) | 批量替换、删除文本内容,支持流处理 | 13121 |
-| | [echo_mcp](#echo_mcp) | 将文本内容写入文件(覆盖/追加模式) | 13125 |
+OE-智能运维助手通过 42 个标准化 MCP 工具,构建“基础信息与命令执行-进程与系统监控-网络监控与安全-硬件与存储管理-文件与文本操作”五大核心能力模块,覆盖日常运维 95% 以上高频场景,具体服务与工具映射如下:
+
+| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
+|----------|------------------------|--------------|----------|
+| 一、基础信息与命令执行 | [remote_info_mcp](#remote_info_mcp) | 获取本地/远程节点基础信息(系统版本、硬件型号) | 12100 |
+| | [shell_generator_mcp](#shell_generator_mcp) | 生成并执行 Shell 命令,支撑自然语言指令解析 | 12101 |
+| 二、进程与系统监控 | [kill_mcp](#kill_mcp) | 终止进程、查看进程信号量含义,处理异常进程 | 12111 |
+| | [nohup_mcp](#nohup_mcp) | 后台启动进程,避免终端退出导致进程中断 | 12112 |
+| | [strace_mcp](#strace_mcp) | 跟踪进程系统调用,分析异常进程的行为逻辑 | 12113 |
+| | [top_mcp](#top_mcp) | 查看 CPU/内存/进程负载,识别高占用资源进程 | 12110 |
+| | [perf_interrupt_mcp](#perf_interrupt_mcp) | 定位高频中断源,分析中断导致的 CPU 占用 | 12220 |
+| | [flame_graph_mcp](#flame_graph_mcp) | 生成 CPU 耗时火焰图,可视化函数调用栈瓶颈 | 12222 |
+| 三、网络监控与安全 | [iftop_mcp](#iftop_mcp) | 实时监控指定网卡流量,按连接/主机统计带宽占用 | 12116 |
+| | [nload_mcp](#nload_mcp) | 可视化展示网卡入/出带宽变化,识别带宽瓶颈 | 12117 |
+| | [netstat_mcp](#netstat_mcp) | 查看网络连接状态、端口占用、协议统计,排查连接异常 | 12118 |
+| | [lsof_mcp](#lsof_mcp) | 定位文件占用冲突、网络连接对应的进程,解决资源争抢 | 12119 |
+| | [ifconfig_mcp](#ifconfig_mcp) | 查看/配置网络接口 IP、MAC 地址,诊断网卡基础问题 | 12120 |
+| | [ethtool_mcp](#ethtool_mcp) | 查询网卡特性(速率/双工模式),配置网卡参数 | 12121 |
+| | [tshark_mcp](#tshark_mcp) | 捕获网络数据包,分析协议异常(如丢包、延迟) | 12122 |
+| | [firewalld_mcp](#firewalld_mcp) | 配置防火墙规则、Zone,管控端口访问权限 | 12130 |
+| | [iptables_mcp](#iptables_mcp) | 配置 iptables 包过滤与 NAT 规则,强化网络安全 | 12131 |
+| | [nmap_mcp](#nmap_mcp) | 扫描目标 IP 存活状态、开放端口,排查网络可达性 | 12135 |
+| 四、硬件与存储管理 | [lscpu_mcp](#lscpu_mcp) | 采集 CPU 架构、核心数、NUMA 节点等静态信息 | 12202 |
+| | [free_mcp](#free_mcp) | 查看系统内存、Swap 整体使用状态,识别内存不足 | 13100 |
+| | [sync_mcp](#sync_mcp) | 将内存缓冲区数据强制写入磁盘,避免数据丢失 | 13103 |
+| | [swapon_mcp](#swapon_mcp) | 启用 Swap 设备/文件,扩展虚拟内存 | 13104 |
+| | [swapoff_mcp](#swapoff_mcp) | 停用 Swap 设备/文件,释放磁盘资源 | 13105 |
+| | [fallocate_mcp](#fallocate_mcp) | 快速创建指定大小的 Swap 文件,应急扩展内存 | 13106 |
+| 五、文件与文本操作 | [file_content_tool_mcp](#file_content_tool_mcp) | 对文件内容进行增、删、改、查,处理文本类需求 | 12125 |
+| | [file_transfer_mcp](#file_transfer_mcp) | 本地与远程节点间文件传输、下载,支持批量操作 | 12136 |
+| | [find_mcp](#find_mcp) | 按名称/大小/修改时间等条件查找文件 | 13107 |
+| | [touch_mcp](#touch_mcp) | 创建空文件、修改文件访问/修改时间 | 13108 |
+| | [mkdir_mcp](#mkdir_mcp) | 创建单个/多级文件夹,支持权限设置 | 13109 |
+| | [rm_mcp](#rm_mcp) | 删除文件/文件夹,支持强制删除 | 13110 |
+| | [mv_mcp](#mv_mcp) | 移动文件到指定路径,或修改文件名称 | 13111 |
+| | [ls_mcp](#ls_mcp) | 查看目录下文件/文件夹名称、权限、大小 | 13112 |
+| | [head_mcp](#head_mcp) | 查看文件前 N 行内容(默认前 10 行) | 13113 |
+| | [tail_mcp](#tail_mcp) | 查看文件后 N 行内容,支持实时跟踪(-f) | 13114 |
+| | [cat_mcp](#cat_mcp) | 查看文件全部内容,支持多文件合并查看 | 13115 |
+| | [chmod_mcp](#chmod_mcp) | 修改文件/文件夹的读、写、执行权限 | 13117 |
+| | [chown_mcp](#chown_mcp) | 修改文件/文件夹的所有者(用户/用户组) | 13116 |
+| | [tar_mcp](#tar_mcp) | 打包/解包文件,支持 gzip/bzip2 压缩 | 13118 |
+| | [zip_mcp](#zip_mcp) | 压缩/解压 zip 格式文件,支持密码保护 | 13119 |
+| | [grep_mcp](#grep_mcp) | 按关键词搜索文件内容,支持正则匹配 | 13120 |
+| | [sed_mcp](#sed_mcp) | 批量替换、删除文本内容,支持流处理 | 13121 |
+| | [echo_mcp](#echo_mcp) | 将文本内容写入文件(覆盖/追加模式) | 13125 |
### 2.2 使用案例
@@ -97,42 +97,45 @@ OE-智能运维助手通过42个标准化MCP工具,构建“基础信息与命
- 场景 1:服务器网络卡顿排查(eth0 网卡,访问内网服务延迟高)
```text
- 本地服务器访问内网192.168.2.5的业务服务时延迟超300ms,eth0网卡存在卡顿,帮我排查:
- 1. 查看eth0网卡的实时流量(按源/目的IP统计)、入/出带宽占用峰值;
- 2. 找出当前与192.168.2.5的网络连接数,及对应进程PID与名称,排查是否有异常连接;
- 3. 检查firewalld对192.168.2.0/24网段的访问规则,是否有端口拦截,最后给出优化建议
+ 本地服务器访问内网 192.168.2.5 的业务服务时延迟超 300ms,eth0 网卡存在卡顿,帮我排查:
+ 1. 查看 eth0 网卡的实时流量(按源/目的 IP 统计)、入/出带宽占用峰值;
+ 2. 找出当前与 192.168.2.5 的网络连接数,及对应进程 PID 与名称,排查是否有异常连接;
+ 3. 检查 firewalld 对 192.168.2.0/24 网段的访问规则,是否有端口拦截,最后给出优化建议。
```
- 场景 2:远程节点资源持续监控(192.168.1.100,监控业务高峰期负载)
```text
- 帮我持续监控192.168.1.100节点(业务高峰期10:00-12:00,每5秒刷新1次):
- 1. 查看CPU 1/5/15分钟平均负载、内存使用前5的进程(显示进程名、PID、已用内存占比);
- 2. 监控磁盘根分区(/)的使用率,若超过85%实时提醒;
- 3. 记录监控周期内的CPU最高负载、内存最大占用率,生成简易统计报告
+ 帮我持续监控 192.168.1.100 节点(业务高峰期 10:00-12:00,每 5 秒刷新 1 次):
+ 1. 查看 CPU 1/5/15 分钟平均负载、内存使用前 5 的进程(显示进程名、PID、已用内存占比);
+ 2. 监控磁盘根分区(/)的使用率,若超过 85% 实时提醒;
+ 3. 记录监控周期内的 CPU 最高负载、内存最大占用率,生成简易统计报告。
```
-- 场景 3:跨节点文件传输与配置修改(本地→192.168.1.101,业务配置更新)
+- 场景 3:跨节点文件传输与配置修改(本地 → 192.168.1.101,业务配置更新)
```text
帮我完成两项操作:
- 1. 将本地/usr/local/app/conf/new_app.conf文件传输到192.168.1.101的/opt/app/conf/目录,覆盖旧文件前先备份为app.conf.bak;
- 2. 修改192.168.1.101上/opt/app/conf/app.ini文件中“max_connection”的值为500,“timeout”的值为300,修改后验证配置文件语法正确性
+ 1. 将本地 /usr/local/app/conf/new_app.conf 文件传输到 192.168.1.101 的 /opt/app/conf/ 目录,覆盖旧文件前先备份为 app.conf.bak;
+ 2. 修改 192.168.1.101 上 /opt/app/conf/app.ini 文件中 "max_connection" 的值为 500,"timeout" 的值为 300,修改后验证配置文件语法正确性。
```
- 场景 4:异常进程处理与后台重启(本地 “api-service” 进程 CPU 高占用)
```text
- 本地“api-service”进程(PID约2345)占用CPU长期超90%且接口响应超时,帮我处理:1. 先查看该进程的系统调用情况(重点看I/O相关调用),再用SIGKILL信号强制终止进程;2. 用nohup后台重启进程,指定启动参数“--config /etc/api-service/config.yaml”,日志输出到/var/log/api-service/run.log;3. 重启后检查进程PID、监听端口(8080)是否正常,及前10条日志是否有报错
+ 本地 "api-service" 进程(PID 约 2345)占用 CPU 长期超 90% 且接口响应超时,帮我处理:
+ 1. 先查看该进程的系统调用情况(重点看 I/O 相关调用),再用 SIGKILL 信号强制终止进程;
+ 2. 用 nohup 后台重启进程,指定启动参数 "--config /etc/api-service/config.yaml",日志输出到 /var/log/api-service/run.log;
+ 3. 重启后检查进程 PID、监听端口(8080)是否正常,及前 10 条日志是否有报错。
```
- 场景 5:远程节点硬件与系统信息采集(192.168.1.102,新节点入网检测)
```text
- 帮我采集192.168.1.102新入网节点的硬件与系统基础信息:
- 1. 查看CPU详细信息(架构、物理核心数、逻辑核心数、NUMA节点分布、主频范围);
- 2. 获取系统版本、内核版本、主机名、IP地址列表;
- 3. 查看物理内存总大小、内存通道数、单条内存容量与频率,及磁盘分区布局(重点看/data分区大小与文件系统类型),结果以结构化格式返回
+ 帮我采集 192.168.1.102 新入网节点的硬件与系统基础信息:
+ 1. 查看 CPU 详细信息(架构、物理核心数、逻辑核心数、NUMA 节点分布、主频范围);
+ 2. 获取系统版本、内核版本、主机名、IP 地址列表;
+ 3. 查看物理内存总大小、内存通道数、单条内存容量与频率,及磁盘分区布局(重点看 /data 分区大小与文件系统类型),结果以结构化格式返回。
```
@@ -147,78 +150,99 @@ OE-智算调优助手是 openEuler Intelligence 体系下的**异构智算场景
OE-智算调优助手基于 28 个标准化 MCP 工具,构建“异构硬件监控-智算任务诊断-基础运维支撑”三大核心模块,精准匹配智算场景从“硬件状态感知”到“任务问题解决”的全流程需求,具体服务与工具映射如下:
-| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
-|---------------|-------------------------------------------------|------------------------------------------------|-------|
-| 一、异构硬件监控 | [nvidia_mcp](#nvidia_mcp) | 实时监控 NVIDIA GPU 状态(负载、显存占用、温度、驱动版本),支持多卡同时查看 | 12114 |
-| | [npu_mcp](#npu_mcp) | 监控 NPU 资源使用情况(算力利用率、内存占用),配置 NPU 任务绑定参数 | 12115 |
-| 二、智算任务诊断 | [strace_mcp](#strace_mcp) | 跟踪智算任务进程的系统调用,定位 I/O 瓶颈(如数据读取超时、网络请求阻塞) | 12113 |
-| | [top_mcp](#top_mcp) | 查看智算节点 CPU/内存/进程负载,识别抢占 GPU 资源的异常进程 | 12110 |
-| 三、智算任务运维 | [shell_generator_mcp](#shell_generator_mcp) | 生成智算场景专属命令(如 GPU 任务绑定指令、模型训练启动脚本) | 12101 |
-| | [nohup_mcp](#nohup_mcp) | 后台启动长时智算任务(如 AI 模型训练),避免终端退出导致任务中断 | 12112 |
-| | [kill_mcp](#kill_mcp) | 终止异常智算任务(如显存溢出的训练进程、无响应的推理服务) | 12111 |
-| 四、网络与安全管控 | [firewalld_mcp](#firewalld_mcp) | 配置智算节点防火墙规则,开放 AI 服务端口(如 TensorBoard 6006 端口、推理服务 8080 端口) | 12130 |
-| | [iptables_mcp](#iptables_mcp) | 管控智算节点网络访问,限制未授权设备连接 GPU 节点,保障数据安全 | 12131 |
-| 五、文件与数据管理 | [file_transfer_mcp](#file_transfer_mcp) | 传输智算任务数据(如模型文件、训练数据集、 checkpoint 文件),支持跨节点批量传输 | 12136 |
-| | [file_content_tool_mcp](#file_content_tool_mcp) | 编辑智算任务配置文件(如模型参数 yaml、训练超参 json),支持批量修改 | 12125 |
-| | [find_mcp](#find_mcp) | 查找智算节点上的目标文件(如指定版本的模型文件、训练日志) | 13107 |
-| | [cat_mcp](#cat_mcp) | 查看智算任务日志(如训练报错日志、推理服务运行日志) | 13115 |
-| | [tail_mcp](#tail_mcp) | 实时跟踪智算任务日志,监控训练进度(如 loss 变化、epoch 完成情况) | 13114 |
-| 六、基础系统操作 | [ls_mcp](#ls_mcp) | 查看智算任务目录内容(如训练输出文件夹、模型权重文件列表) | 13112 |
-| | [rm_mcp](#rm_mcp) | 删除智算节点冗余文件(如过期训练日志、损坏的 checkpoint 文件) | 13110 |
-| | [mv_mcp](#mv_mcp) | 移动智算任务文件(如将训练完成的模型文件迁移到存储目录) | 13111 |
-| | [touch_mcp](#touch_mcp) | 创建智算任务所需空文件(如日志记录文件、任务标记文件) | 13108 |
-| | [mkdir_mcp](#mkdir_mcp) | 创建智算任务目录(如按日期划分的训练输出目录) | 13109 |
-| 七、压缩与权限管理 | [tar_mcp](#tar_mcp) | 打包/解包智算任务数据(如压缩训练数据集、解压模型文件包) | 13118 |
-| | [zip_mcp](#zip_mcp) | 压缩智算日志文件(如训练全量日志),减少存储占用 | 13119 |
-| | [chmod_mcp](#chmod_mcp) | 修改智算任务文件权限(如给模型文件设置只读权限、给启动脚本设置执行权限) | 13117 |
-| | [chown_mcp](#chown_mcp) | 修改智算任务文件所有者(如将模型文件授权给训练用户) | 13116 |
-| 八、文本处理与同步 | [grep_mcp](#grep_mcp) | 搜索智算日志中的关键词(如“error”“out of memory”报错信息) | 13120 |
-| | [sed_mcp](#sed_mcp) | 批量替换智算配置文件内容(如修改所有训练脚本的 batch size 参数) | 13121 |
-| | [echo_mcp](#echo_mcp) | 将文本内容写入智算任务文件(如向日志文件添加任务标记) | 13125 |
-| | [sync_mcp](#sync_mcp) | 将智算任务内存数据强制写入磁盘(如训练 checkpoint 临时文件),避免数据丢失 | 13103 |
-| | [head_mcp](#head_mcp) | 查看智算文件前 N 行内容(如快速预览训练配置文件) | 13113 |
-| 九、AI慢节点检测 | [systrace_mcp](#systrace_mcp) | AI 训练任务性能分析与优化建议(基于全栈跟踪数据,识别 Host bound、算子慢、CPU 抢占等性能瓶颈,提供针对性调优方向,降低故障导致的训练成本浪费)| 12145 |
+| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
+|----------|------------------------|--------------|----------|
+| 一、异构硬件监控 | [nvidia_mcp](#nvidia_mcp) | 实时监控 NVIDIA GPU 状态(负载、显存占用、温度、驱动版本),支持多卡同时查看 | 12114 |
+| | [npu_mcp](#npu_mcp) | 监控 NPU 资源使用情况(算力利用率、内存占用),配置 NPU 任务绑定参数 | 12115 |
+| 二、智算任务诊断 | [strace_mcp](#strace_mcp) | 跟踪智算任务进程的系统调用,定位 I/O 瓶颈(如数据读取超时、网络请求阻塞) | 12113 |
+| | [top_mcp](#top_mcp) | 查看智算节点 CPU/内存/进程负载,识别抢占 GPU 资源的异常进程 | 12110 |
+| 三、智算任务运维 | [shell_generator_mcp](#shell_generator_mcp) | 生成智算场景专属命令(如 GPU 任务绑定指令、模型训练启动脚本) | 12101 |
+| | [nohup_mcp](#nohup_mcp) | 后台启动长时智算任务(如 AI 模型训练),避免终端退出导致任务中断 | 12112 |
+| | [kill_mcp](#kill_mcp) | 终止异常智算任务(如显存溢出的训练进程、无响应的推理服务) | 12111 |
+| 四、网络与安全管控 | [firewalld_mcp](#firewalld_mcp) | 配置智算节点防火墙规则,开放 AI 服务端口(如 TensorBoard 6006 端口、推理服务 8080 端口) | 12130 |
+| | [iptables_mcp](#iptables_mcp) | 管控智算节点网络访问,限制未授权设备连接 GPU 节点,保障数据安全 | 12131 |
+| 五、文件与数据管理 | [file_transfer_mcp](#file_transfer_mcp) | 传输智算任务数据(如模型文件、训练数据集、checkpoint 文件),支持跨节点批量传输 | 12136 |
+| | [file_content_tool_mcp](#file_content_tool_mcp) | 编辑智算任务配置文件(如模型参数 yaml、训练超参 json),支持批量修改 | 12125 |
+| | [find_mcp](#find_mcp) | 查找智算节点上的目标文件(如指定版本的模型文件、训练日志) | 13107 |
+| | [cat_mcp](#cat_mcp) | 查看智算任务日志(如训练报错日志、推理服务运行日志) | 13115 |
+| | [tail_mcp](#tail_mcp) | 实时跟踪智算任务日志,监控训练进度(如 loss 变化、epoch 完成情况) | 13114 |
+| 六、基础系统操作 | [ls_mcp](#ls_mcp) | 查看智算任务目录内容(如训练输出文件夹、模型权重文件列表) | 13112 |
+| | [rm_mcp](#rm_mcp) | 删除智算节点冗余文件(如过期训练日志、损坏的 checkpoint 文件) | 13110 |
+| | [mv_mcp](#mv_mcp) | 移动智算任务文件(如将训练完成的模型文件迁移到存储目录) | 13111 |
+| | [touch_mcp](#touch_mcp) | 创建智算任务所需空文件(如日志记录文件、任务标记文件) | 13108 |
+| | [mkdir_mcp](#mkdir_mcp) | 创建智算任务目录(如按日期划分的训练输出目录) | 13109 |
+| 七、压缩与权限管理 | [tar_mcp](#tar_mcp) | 打包/解包智算任务数据(如压缩训练数据集、解压模型文件包) | 13118 |
+| | [zip_mcp](#zip_mcp) | 压缩智算日志文件(如训练全量日志),减少存储占用 | 13119 |
+| | [chmod_mcp](#chmod_mcp) | 修改智算任务文件权限(如给模型文件设置只读权限、给启动脚本设置执行权限) | 13117 |
+| | [chown_mcp](#chown_mcp) | 修改智算任务文件所有者(如将模型文件授权给训练用户) | 13116 |
+| 八、文本处理与同步 | [grep_mcp](#grep_mcp) | 搜索智算日志中的关键词(如 "error" "out of memory" 报错信息) | 13120 |
+| | [sed_mcp](#sed_mcp) | 批量替换智算配置文件内容(如修改所有训练脚本的 batch size 参数) | 13121 |
+| | [echo_mcp](#echo_mcp) | 将文本内容写入智算任务文件(如向日志文件添加任务标记) | 13125 |
+| | [sync_mcp](#sync_mcp) | 将智算任务内存数据强制写入磁盘(如训练 checkpoint 临时文件),避免数据丢失 | 13103 |
+| | [head_mcp](#head_mcp) | 查看智算文件前 N 行内容(如快速预览训练配置文件) | 13113 |
+| 九、AI 慢节点检测 | [systrace_mcp](#systrace_mcp) | AI 训练任务性能分析与优化建议(基于全栈跟踪数据,识别 Host bound、算子慢、CPU 抢占等性能瓶颈,提供针对性调优方向,降低故障导致的训练成本浪费) | 12145 |
### 3.2 使用案例
-以下按“GPU训练监控、NPU推理部署、显存溢出排查、跨节点资源对比、训练日志分析”五大智算高频场景分类,提供自然语言交互 Prompt 格式,直接替换节点IP、任务名、文件路径等关键信息即可使用,所有场景均贴合企业AI训练与推理实际运维需求。
+以下按“GPU 训练监控、NPU 推理部署、显存溢出排查、跨节点资源对比、训练日志分析”五大智算高频场景分类,提供自然语言交互 Prompt 格式,直接替换节点 IP、任务名、文件路径等关键信息即可使用,所有场景均贴合企业 AI 训练与推理实际运维需求。
- 场景 1:GPU 模型训练实时监控(BERT 预训练任务,GPU 0/1 双卡)
```text
- 本地正在用 GPU 0/1 双卡运行 BERT 模型预训练(进程名:bert-train),帮我实时监控:1. 每3秒刷新一次 GPU 0/1 的负载(%)、已用显存/总显存(如 8192MiB/16384MiB)、核心温度;2. 跟踪训练日志 /data/train_logs/bert-train-202501.log,当出现“epoch”“loss”关键词时,实时输出最新15行日志;3. 若任一 GPU 温度超 88℃ 或显存占用超 90%,立即触发提醒并给出临时降载建议
+ 本地正在用 GPU 0/1 双卡运行 BERT 模型预训练(进程名:bert-train),帮我实时监控:
+ 1. 每 3 秒刷新一次 GPU 0/1 的负载(%)、已用显存/总显存(如 8192MiB/16384MiB)、核心温度;
+ 2. 跟踪训练日志 /data/train_logs/bert-train-202501.log,当出现 "epoch" "loss" 关键词时,实时输出最新 15 行日志;
+ 3. 若任一 GPU 温度超 88℃ 或显存占用超 90%,立即触发提醒并给出临时降载建议。
```
- 场景 2:NPU 推理服务部署与状态验证(192.168.3.20 NPU 节点)
```text
- 帮我在 192.168.3.20 NPU 节点部署图像分类推理服务:1. 先查看 NPU 0/1 的资源使用情况(算力利用率、内存占用),筛选空闲率超 80% 的 NPU 设备;2. 用 nohup 后台启动“img-cls-infer”服务,绑定空闲 NPU 设备,指定配置文件 /etc/infer/img-cls.conf,日志输出到 /var/log/infer/img-cls.log;3. 启动后检查服务进程 PID、监听端口(9000)是否正常,发送测试请求验证推理响应是否正常
+ 帮我在 192.168.3.20 NPU 节点部署图像分类推理服务:
+ 1. 先查看 NPU 0/1 的资源使用情况(算力利用率、内存占用),筛选空闲率超 80% 的 NPU 设备;
+ 2. 用 nohup 后台启动 "img-cls-infer" 服务,绑定空闲 NPU 设备,指定配置文件 /etc/infer/img-cls.conf,日志输出到 /var/log/infer/img-cls.log;
+ 3. 启动后检查服务进程 PID、监听端口(9000)是否正常,发送测试请求验证推理响应是否正常。
```
- 场景 3:GPU 训练显存溢出问题定位与优化(YOLOv8 训练任务)
```text
- 本地 YOLOv8 目标检测训练任务(PID:3456)报“CUDA out of memory”后中断,帮我排查优化:1. 查看当前所有 GPU 的显存占用详情,定位占用最高的进程及关联任务;2. 用 strace 跟踪该任务中断前的系统调用,分析是否存在异常内存申请(如重复加载数据集);3. 结合任务配置给出优化方案(如调整 batch size、启用梯度 checkpoint、使用混合精度训练),并生成修改后的启动命令
+ 本地 YOLOv8 目标检测训练任务(PID:3456)报“CUDA out of memory”后中断,帮我排查优化:
+ 1. 查看当前所有 GPU 的显存占用详情,定位占用最高的进程及关联任务;
+ 2. 用 strace 跟踪该任务中断前的系统调用,分析是否存在异常内存申请(如重复加载数据集);
+ 3. 结合任务配置给出优化方案(如调整 batch size、启用梯度 checkpoint、使用混合精度训练),并生成修改后的启动命令。
```
- 场景 4:跨 GPU 节点资源对比与任务分配(192.168.3.10/11 节点)
```text
- 需新增 Transformer 模型训练任务,帮我对比 192.168.3.10 和 192.168.3.11 两台 GPU 节点:1. 查看两台节点的 GPU 型号、数量、单卡总显存及当前整体显存占用率;2. 对比两台节点已运行任务的 GPU 平均负载(10分钟内)、CPU 空闲核心数;3. 结合新任务(预计单卡显存占用 12GiB,负载 70%),判断哪台节点更适合部署,并给出任务绑定 GPU 的建议
+ 需新增 Transformer 模型训练任务,帮我对比 192.168.3.10 和 192.168.3.11 两台 GPU 节点:
+ 1. 查看两台节点的 GPU 型号、数量、单卡总显存及当前整体显存占用率;
+ 2. 对比两台节点已运行任务的 GPU 平均负载(10分钟内)、CPU 空闲核心数;
+ 3. 结合新任务(预计单卡显存占用 12GiB,负载 70%),判断哪台节点更适合部署,并给出任务绑定 GPU 的建议。
```
- 场景 5:智算训练日志批量分析与问题定位(多节点训练日志)
```text
- 192.168.3.10/11/12 三台 GPU 节点的分布式训练任务频繁中断,帮我分析日志:1. 批量获取三台节点的训练日志(路径 /data/dist-train/logs/train.log),传输到本地 /tmp/analysis/ 目录;2. 搜索所有日志中的“error”“timeout”“crash”关键词,统计各错误出现频次及对应节点;3. 提取错误前后各20行日志内容,定位是否存在节点间通信超时或硬件资源不足问题,生成分析报告
+ 192.168.3.10/11/12 三台 GPU 节点的分布式训练任务频繁中断,帮我分析日志:
+ 1. 批量获取三台节点的训练日志(路径 /data/dist-train/logs/train.log),传输到本地 /tmp/analysis/ 目录;
+ 2. 搜索所有日志中的 "error" "timeout" "crash" 关键词,统计各错误出现频次及对应节点;
+ 3. 提取错误前后各 20 行日志内容,定位是否存在节点间通信超时或硬件资源不足问题,生成分析报告。
```
- 场景 6:AI训练任务慢节点检测
```text
- 1、在ai训练任务机器上部署systrace 采集部件,并完成数据采集 参考 https://gitee.com/openeuler/sysTrace/blob/master/docs/0.quickstart.md
- 2、修改/etc/systrace/config 目录下的配置文件 参考 https://gitee.com/openeuler/sysTrace/blob/master/systrace_mcp/README.md
- 3、使用智能体进行对话:帮我分析ip机器的ai训练情况。
+ 1. 在ai训练任务机器上部署 systrace 采集部件,并完成数据采集 ,参考 https://gitee.com/openeuler/sysTrace/blob/master/docs/0.quickstart.md
+ ```
+
+ ```text
+ 2. 修改/etc/systrace/config 目录下的配置文件,参考 https://gitee.com/openeuler/sysTrace/blob/master/systrace_mcp/README.md
+ ```
+
+ ```text
+ 3. 使用智能体进行对话:帮我分析 ip 机器的 ai 训练情况。
```
@@ -233,49 +257,49 @@ OE-通算调优助手是 openEuler Intelligence 体系下的**通用计算场景
OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优化-系统性能诊断-通用计算运维-调优效果验证”四大核心模块,精准匹配通用计算场景从“硬件拓扑感知”到“性能持续优化”的全流程需求,具体服务与工具映射如下:
-| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
-|-------------------------|-----------------------------|------------------------------------------------|-----------|
-| 一、NUMA 架构优化 | [numa_topo_mcp](#numa_topo_mcp) | 采集 NUMA 硬件拓扑(节点分布、CPU/内存绑定关系)与系统配置,生成拓扑图 | 12203 |
-| | [numa_bind_proc_mcp](#numa_bind_proc_mcp) | 启动时将进程绑定到指定 NUMA 节点,避免跨节点内存访问损耗 | 12204 |
-| | [numa_rebind_proc_mcp](#numa_rebind_proc_mcp) | 动态调整已运行进程的 NUMA 绑定,实时优化资源分配 | 12205 |
-| | [numa_container_mcp](#numa_container_mcp) | 监控 Docker 容器的 NUMA 内存访问模式,优化容器化应用性能 | 12214 |
-| | [numastat_mcp](#numastat_mcp) | 统计系统整体 NUMA 内存访问情况(本地/远程访问比例),识别跨节点访问过高问题 | 12210 |
-| | [numa_cross_node_mcp](#numa_cross_node_mcp) | 定位导致跨节点内存访问过高的进程,量化性能损耗 | 12211 |
-| | [numa_perf_compare_mcp](#numa_perf_compare_mcp) | 对比不同 NUMA 绑定策略下的任务性能(响应时间、吞吐量),筛选最优方案 | 12208 |
-| | [numa_diagnose_mcp](#numa_diagnose_mcp) | 通过 NUMA 绑定控制变量法,定位硬件级性能异常(如内存控制器瓶颈) | 12209 |
-| 二、系统性能诊断 | [hotspot_trace_mcp](#hotspot_trace_mcp) | 快速定位系统/进程的 CPU 热点函数(基于 perf 采样),识别计算瓶颈 | 12216 |
-| | [cache_miss_audit_mcp](#cache_miss_audit_mcp) | 分析 CPU 缓存失效(L1/L2/L3)原因,量化缓存损耗对性能的影响 | 12217 |
-| | [func_timing_trace_mcp](#func_timing_trace_mcp) | 精准测量函数执行时间与调用栈,定位耗时过长的关键路径 | 12218 |
-| | [strace_syscall_mcp](#strace_syscall_mcp) | 跟踪进程系统调用频率与耗时,排查不合理的 I/O 或网络调用 | 12219 |
-| | [perf_interrupt_mcp](#perf_interrupt_mcp) | 分析高频中断源(如网卡、定时器)对 CPU 的占用,定位中断导致的性能下降 | 12220 |
-| | [flame_graph_mcp](#flame_graph_mcp) | 生成 CPU 火焰图/内存火焰图,可视化展示函数调用栈与性能瓶颈分布 | 12222 |
-| 三、通用计算监控 | [lscpu_mcp](#lscpu_mcp) | 采集 CPU 架构细节(核心数、主频、缓存大小、NUMA 节点关联) | 12202 |
-| | [top_mcp](#top_mcp) | 实时监控 CPU/内存/进程负载,聚焦通用计算任务的资源占用趋势 | 12110 |
-| | [vmstat_mcp](#vmstat_mcp) | 采集系统资源交互指标(上下文切换、IOPS、Swap 使用),识别瓶颈点 | 13101 |
-| | [sar_mcp](#sar_mcp) | 周期性记录系统性能数据(CPU 使用率、内存页交换、网络吞吐量),支持历史回溯 | 13102 |
-| | [free_mcp](#free_mcp) | 查看系统内存/ Swap 整体使用状态,识别内存不足对通用计算的影响 | 13100 |
-| 四、调优任务运维 | [shell_generator_mcp](#shell_generator_mcp) | 生成 NUMA 绑定、性能测试等场景的专属命令(如 numactl 启动指令) | 12101 |
-| | [nohup_mcp](#nohup_mcp) | 后台启动长时性能测试任务(如压力测试、基准测试),避免终端中断 | 12112 |
-| | [kill_mcp](#kill_mcp) | 终止异常性能测试进程(如资源耗尽的压力测试任务) | 12111 |
-| | euler-copilot-tune_mcp | 调用 Euler 调优模型,生成基于场景的自动化调优建议(如内核参数调整) | 12147 |
-| 五、文件与配置管理 | [file_transfer_mcp](#file_transfer_mcp) | 传输性能测试数据、调优配置文件(如基准测试结果、NUMA 绑定脚本) | 12136 |
-| | [file_content_tool_mcp](#file_content_tool_mcp) | 编辑系统配置文件(如内核参数 sysctl.conf、应用性能配置) | 12125 |
-| | [grep_mcp](#grep_mcp) | 搜索性能日志中的关键指标(如“cache miss”“numa node”) | 13120 |
-| | [sed_mcp](#sed_mcp) | 批量修改调优配置文件(如全局调整应用的内存分配策略) | 13121 |
-| | [cat_mcp](#cat_mcp) | 查看性能测试日志、系统监控报告(如 sar 历史数据) | 13115 |
-| | [tail_mcp](#tail_mcp) | 实时跟踪性能测试日志(如压力测试的 QPS 变化) | 13114 |
-| 六、基础系统操作 | [ls_mcp](#ls_mcp) | 查看性能测试目录、调优工具路径(如 perf 报告存放目录) | 13112 |
-| | [mkdir_mcp](#mkdir_mcp) | 创建性能测试工作目录(如按日期划分的基准测试结果目录) | 13109 |
-| | [rm_mcp](#rm_mcp) | 删除冗余性能日志、过期测试数据 | 13110 |
-| | [mv_mcp](#mv_mcp) | 归档性能测试结果(如将调优前后的对比数据移动到归档目录) | 13111 |
-| | [sync_mcp](#sync_mcp) | 将性能测试临时数据写入磁盘(如基准测试中间结果),避免数据丢失 | 13103 |
-| 七、压缩与权限管理 | [tar_mcp](#tar_mcp) | 打包性能测试日志(如全量 sar 监控数据),减少存储空间占用 | 13118 |
-| | [zip_mcp](#zip_mcp) | 压缩调优配置文件包,便于跨节点分发 | 13119 |
-| | [chmod_mcp](#chmod_mcp) | 修改性能测试工具、调优脚本的执行权限 | 13117 |
-| | [chown_mcp](#chown_mcp) | 授权调优用户访问性能监控数据文件 | 13116 |
-| 八、远程与网络管控 | [remote_info_mcp](#remote_info_mcp) | 获取远程通用计算节点的基础信息(系统版本、硬件配置) | 12100 |
-| | [firewalld_mcp](#firewalld_mcp) | 配置性能监控工具的端口访问规则(如允许远程访问 sar 数据端口) | 12130 |
-| | [iptables_mcp](#iptables_mcp) | 管控通用计算节点的网络访问,保障性能测试环境安全 | 12131 |
+| 服务分类 | MCP 工具名称(带锚点) | 核心功能定位 | 默认端口 |
+|----------|------------------------|--------------|----------|
+| 一、NUMA 架构优化 | [numa_topo_mcp](#numa_topo_mcp) | 采集 NUMA 硬件拓扑(节点分布、CPU/内存绑定关系)与系统配置,生成拓扑图 | 12203 |
+| | [numa_bind_proc_mcp](#numa_bind_proc_mcp) | 启动时将进程绑定到指定 NUMA 节点,避免跨节点内存访问损耗 | 12204 |
+| | [numa_rebind_proc_mcp](#numa_rebind_proc_mcp) | 动态调整已运行进程的 NUMA 绑定,实时优化资源分配 | 12205 |
+| | [numa_container_mcp](#numa_container_mcp) | 监控 Docker 容器的 NUMA 内存访问模式,优化容器化应用性能 | 12214 |
+| | [numastat_mcp](#numastat_mcp) | 统计系统整体 NUMA 内存访问情况(本地/远程访问比例),识别跨节点访问过高问题 | 12210 |
+| | [numa_cross_node_mcp](#numa_cross_node_mcp) | 定位导致跨节点内存访问过高的进程,量化性能损耗 | 12211 |
+| | [numa_perf_compare_mcp](#numa_perf_compare_mcp) | 对比不同 NUMA 绑定策略下的任务性能(响应时间、吞吐量),筛选最优方案 | 12208 |
+| | [numa_diagnose_mcp](#numa_diagnose_mcp) | 通过 NUMA 绑定控制变量法,定位硬件级性能异常(如内存控制器瓶颈) | 12209 |
+| 二、系统性能诊断 | [hotspot_trace_mcp](#hotspot_trace_mcp) | 快速定位系统/进程的 CPU 热点函数(基于 perf 采样),识别计算瓶颈 | 12216 |
+| | [cache_miss_audit_mcp](#cache_miss_audit_mcp) | 分析 CPU 缓存失效(L1/L2/L3)原因,量化缓存损耗对性能的影响 | 12217 |
+| | [func_timing_trace_mcp](#func_timing_trace_mcp) | 精准测量函数执行时间与调用栈,定位耗时过长的关键路径 | 12218 |
+| | [strace_syscall_mcp](#strace_syscall_mcp) | 跟踪进程系统调用频率与耗时,排查不合理的 I/O 或网络调用 | 12219 |
+| | [perf_interrupt_mcp](#perf_interrupt_mcp) | 分析高频中断源(如网卡、定时器)对 CPU 的占用,定位中断导致的性能下降 | 12220 |
+| | [flame_graph_mcp](#flame_graph_mcp) | 生成 CPU 火焰图/内存火焰图,可视化展示函数调用栈与性能瓶颈分布 | 12222 |
+| 三、通用计算监控 | [lscpu_mcp](#lscpu_mcp) | 采集 CPU 架构细节(核心数、主频、缓存大小、NUMA 节点关联) | 12202 |
+| | [top_mcp](#top_mcp) | 实时监控 CPU/内存/进程负载,聚焦通用计算任务的资源占用趋势 | 12110 |
+| | [vmstat_mcp](#vmstat_mcp) | 采集系统资源交互指标(上下文切换、IOPS、Swap 使用),识别瓶颈点 | 13101 |
+| | [sar_mcp](#sar_mcp) | 周期性记录系统性能数据(CPU 使用率、内存页交换、网络吞吐量),支持历史回溯 | 13102 |
+| | [free_mcp](#free_mcp) | 查看系统内存/Swap 整体使用状态,识别内存不足对通用计算的影响 | 13100 |
+| 四、调优任务运维 | [shell_generator_mcp](#shell_generator_mcp) | 生成 NUMA 绑定、性能测试等场景的专属命令(如 numactl 启动指令) | 12101 |
+| | [nohup_mcp](#nohup_mcp) | 后台启动长时性能测试任务(如压力测试、基准测试),避免终端中断 | 12112 |
+| | [kill_mcp](#kill_mcp) | 终止异常性能测试进程(如资源耗尽的压力测试任务) | 12111 |
+| | euler-copilot-tune_mcp | 调用 Euler 调优模型,生成基于场景的自动化调优建议(如内核参数调整) | 12147 |
+| 五、文件与配置管理 | [file_transfer_mcp](#file_transfer_mcp) | 传输性能测试数据、调优配置文件(如基准测试结果、NUMA 绑定脚本) | 12136 |
+| | [file_content_tool_mcp](#file_content_tool_mcp) | 编辑系统配置文件(如内核参数 sysctl.conf、应用性能配置) | 12125 |
+| | [grep_mcp](#grep_mcp) | 搜索性能日志中的关键指标(如 "cache miss" "numa node") | 13120 |
+| | [sed_mcp](#sed_mcp) | 批量修改调优配置文件(如全局调整应用的内存分配策略) | 13121 |
+| | [cat_mcp](#cat_mcp) | 查看性能测试日志、系统监控报告(如 sar 历史数据) | 13115 |
+| | [tail_mcp](#tail_mcp) | 实时跟踪性能测试日志(如压力测试的 QPS 变化) | 13114 |
+| 六、基础系统操作 | [ls_mcp](#ls_mcp) | 查看性能测试目录、调优工具路径(如 perf 报告存放目录) | 13112 |
+| | [mkdir_mcp](#mkdir_mcp) | 创建性能测试工作目录(如按日期划分的基准测试结果目录) | 13109 |
+| | [rm_mcp](#rm_mcp) | 删除冗余性能日志、过期测试数据 | 13110 |
+| | [mv_mcp](#mv_mcp) | 归档性能测试结果(如将调优前后的对比数据移动到归档目录) | 13111 |
+| | [sync_mcp](#sync_mcp) | 将性能测试临时数据写入磁盘(如基准测试中间结果),避免数据丢失 | 13103 |
+| 七、压缩与权限管理 | [tar_mcp](#tar_mcp) | 打包性能测试日志(如全量 sar 监控数据),减少存储空间占用 | 13118 |
+| | [zip_mcp](#zip_mcp) | 压缩调优配置文件包,便于跨节点分发 | 13119 |
+| | [chmod_mcp](#chmod_mcp) | 修改性能测试工具、调优脚本的执行权限 | 13117 |
+| | [chown_mcp](#chown_mcp) | 授权调优用户访问性能监控数据文件 | 13116 |
+| 八、远程与网络管控 | [remote_info_mcp](#remote_info_mcp) | 获取远程通用计算节点的基础信息(系统版本、硬件配置) | 12100 |
+| | [firewalld_mcp](#firewalld_mcp) | 配置性能监控工具的端口访问规则(如允许远程访问 sar 数据端口) | 12130 |
+| | [iptables_mcp](#iptables_mcp) | 管控通用计算节点的网络访问,保障性能测试环境安全 | 12131 |
### 4.2 使用案例
@@ -287,7 +311,7 @@ OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优
192.168.3.10 这台 MySQL 服务器查询延迟高,帮我做 NUMA 优化:
1. 查看这台服务器的 NUMA 拓扑和各节点内存使用率;
2. 将 mysqld 进程绑定到 NUMA 节点 0,避免跨节点访问;
- 3. 优化后对比查询延迟是否降低,给出优化效果数据
+ 3. 优化后对比查询延迟是否降低,给出优化效果数据。
```
- 场景 2:CPU 缓存未命中率过高问题诊断(应用名:order-service)
@@ -296,7 +320,7 @@ OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优
本地运行的“order-service”应用吞吐量低,怀疑是缓存问题:
1. 审计该应用进程的 L3 缓存未命中率,若超过 5% 标记为异常;
2. 定位导致缓存未命中的高频调用函数;
- 3. 给优化建议(如数据预加载、函数逻辑调整)
+ 3. 给优化建议(如数据预加载、函数逻辑调整)。
```
- 场景 3:容器化应用 NUMA 内存访问监控(容器名:payment-container)
@@ -305,7 +329,7 @@ OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优
帮我监控 Docker 容器“payment-container”:
1. 查看该容器当前的 NUMA 节点内存访问分布;
2. 统计跨节点内存访问的占比,若超过 10% 提醒;
- 3. 给出容器 NUMA 绑定的配置方案
+ 3. 给出容器 NUMA 绑定的配置方案。
```
- 场景 4:NUMA 调优效果对比(调优前后)
@@ -314,7 +338,7 @@ OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优
已给 192.168.4.12 节点的“user-service”应用做 NUMA 绑定(绑定节点 1),帮我验证效果:
1. 对比调优前/后该应用的 CPU 使用率(峰值/平均)、接口响应时间(P95/P99);
2. 查看调优后 NUMA 节点 1 的内存访问命中率(目标提升至 90% 以上)及跨节点访问量;
- 3. 模拟 2000 并发请求压测,对比调优前/后的服务吞吐量、错误率,生成可视化对比报告(含关键指标趋势图)
+ 3. 模拟 2000 并发请求压测,对比调优前/后的服务吞吐量、错误率,生成可视化对比报告(含关键指标趋势图)。
```
- 场景 5:通用计算节点高频中断导致 CPU 占用诊断(192.168.4.13 节点)
@@ -323,14 +347,14 @@ OE-通算调优助手基于 46 个标准化 MCP 工具,构建“NUMA 架构优
192.168.4.13 通用计算节点的空闲 CPU 使用率超 30%,怀疑高频中断问题:
1. 定位该节点的高频中断源(如网卡中断、时钟中断),统计各中断源的 CPU 占用率;
2. 分析高频中断对通用计算任务(如数据处理服务)的影响(如任务上下文切换次数增加、执行延迟变长);
- 3. 给出中断优化方案(如网卡中断队列绑定到独立 NUMA 节点 CPU、调整时钟中断频率),并验证优化后空闲 CPU 使用率是否降至 15% 以下
+ 3. 给出中断优化方案(如网卡中断队列绑定到独立 NUMA 节点 CPU、调整时钟中断频率),并验证优化后空闲 CPU 使用率是否降至 15% 以下。
```
- 场景 6:通用euler-copilot-tune对mysql服务进行调优
```text
- 1、修改/etc/euler-copilot-tune/config 目录下的.env.yaml 和 app_config.yaml 文件,配置目标服务器和调优服务,参考 https://gitee.com/openeuler/A-Tune/tree/euler-copilot-tune/#%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%87%86%E5%A4%87,并重启调优mcp服务 (systemctl restart tune-mcpserver)
- 2、在智能体中使用:帮我采集mysql服务的性能数据、分析性能瓶颈、进行参数推荐、开始调优
+ 1. 修改 /etc/euler-copilot-tune/config 目录下的 .env.yaml 和 app_config.yaml 文件,配置目标服务器和调优服务,参考 https://gitee.com/openeuler/A-Tune/tree/euler-copilot-tune/#%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%87%86%E5%A4%87,并重启调优 MCP 服务(systemctl restart tune-mcpserver);
+ 2. 在智能体中使用:帮我采集 mysql 服务的性能数据、分析性能瓶颈、进行参数推荐、开始调优。
```
@@ -386,7 +410,7 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
帮我在本地部署 Nginx 容器并监控:
1. 拉取 nginx:1.24 镜像,创建名为“web-app”的容器,暴露 80 端口并挂载 /home/nginx/html 到容器内 /usr/share/nginx/html;
2. 启动容器后,实时跟踪容器日志,筛选“error”关键词;
- 3. 查看容器的 CPU/内存使用情况,确认是否正常运行
+ 3. 查看容器的 CPU/内存使用情况,确认是否正常运行。
```
- 场景 2:QEMU 虚拟机创建与配置(虚拟机名:test-vm,内存:4G,CPU:2 核)
@@ -395,7 +419,7 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
帮我创建 QEMU 虚拟机:
1. 基于 /data/images/euleros.qcow2 镜像创建名为“test-vm”的虚拟机,配置 2 核 CPU、4G 内存、100G 磁盘;
2. 启动虚拟机并查看其运行状态;
- 3. 配置虚拟机网络为桥接模式,确保能访问外网
+ 3. 配置虚拟机网络为桥接模式,确保能访问外网。
```
- 场景 3:容器 NUMA 绑定优化(容器名:db-container,NUMA 节点:1)
@@ -404,7 +428,7 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
192.168.4.10 宿主机上的“db-container”容器(MySQL 服务)响应慢,帮我优化:
1. 查看该宿主机的 NUMA 拓扑,确认节点 1 的 CPU/内存资源;
2. 给“db-container”配置 NUMA 绑定,指定使用节点 1 的资源;
- 3. 优化后查看容器的内存访问延迟是否降低
+ 3. 优化后查看容器的内存访问延迟是否降低。
```
- 场景 4:容器镜像跨节点迁移(源节点:192.168.4.10,目标节点:192.168.4.11,镜像名:app:v1.0)
@@ -413,7 +437,7 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
帮我迁移容器镜像:
1. 在 192.168.4.10 上导出“app:v1.0”镜像为 /data/backups/app-v1.0.tar;
2. 将该 tar 包传输到 192.168.4.11 的 /data/images 目录;
- 3. 在目标节点导入该镜像并验证是否可用
+ 3. 在目标节点导入该镜像并验证是否可用。
```
## 6. MCP 总览
@@ -437,552 +461,552 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
### 6.1 MCP_Server列表
-| 端口号 | 服务名称 | 目录路径 | 简介 |
-|--------|------------------------------|-----------------------------------------------|-------------------------------------------------|
-| 12100 | [remote_info_mcp](#remote_info_mcp) | mcp_center/servers/remote_info_mcp | 获取端点信息 |
-| 12101 | [shell_generator_mcp](#shell_generator_mcp) | mcp_center/servers/shell_generator_mcp | 生成&执行shell命令 |
-| 12110 | [top_mcp](#top_mcp) | mcp_center/servers/top_mcp | 获取系统负载信息 |
-| 12111 | [kill_mcp](#kill_mcp) | mcp_center/servers/kill_mcp | 控制进程&查看进程信号量含义 |
-| 12112 | [nohup_mcp](#nohup_mcp) | mcp_center/servers/nohup_mcp | 后台执行进程 |
-| 12113 | [strace_mcp](#strace_mcp) | mcp_center/servers/strace_mcp | 跟踪进程信息,可用于异常情况分析 |
-| 12114 | [nvidia_mcp](#nvidia_mcp) | mcp_center/servers/nvidia_mcp | GPU负载信息查询 |
-| 12115 | [npu_mcp](#npu_mcp) | mcp_center/servers/npu_mcp | NPU的查询和控制 |
-| 12116 | [iftop_mcp](#iftop_mcp) | mcp_center/servers/iftop_mcp | 网络流量监控 |
-| 12117 | [nload_mcp](#nload_mcp) | mcp_center/servers/nload_mcp | Nload带宽监控 |
-| 12118 | [netstat_mcp](#netstat_mcp) | mcp_center/servers/netstat_mcp | netstat网络连接监控 |
-| 12119 | [lsof_mcp](#lsof_mcp) | mcp_center/servers/lsof_mcp | 快速排查文件占用冲突、网络连接异常及进程资源占用问题 |
-| 12120 | [ifconfig_mcp](#ifconfig_mcp) | mcp_center/servers/ifconfig_mcp | ifconfig网络接口信息监控 |
-| 12121 | [ethtool_mcp](#ethtool_mcp) | mcp_center/servers/ethtool_mcp | ethtool网卡信息查询,特性情况,网卡设置 |
-| 12122 | [tshark_mcp](#tshark_mcp) | mcp_center/servers/tshark_mcp | 捕获、显示和分析网络流量 |
-| 12125 | [file_content_tool_mcp](#file_content_tool_mcp) | mcp_center/servers/file_content_tool_mcp | 文件内容增删改查 |
-| 12130 | [firewalld_mcp](#firewalld_mcp) | mcp_center/servers/firewalld_mcp | Firewalld网络防火墙管理工具 |
-| 12131 | [iptables_mcp](#iptables_mcp) | mcp_center/servers/iptables_mcp | iptables防火墙管理工具 |
-| 12133 | [docker_mcp](#docker_mcp) | mcp_center/servers/docker_mcp | docker工具 |
-| 12134 | [qemu_mcp](#qemu_mcp) | mcp_center/servers/qemu_mcp | Qemu虚拟机管理工具 |
-| 12135 | [nmap_mcp](#nmap_mcp) | mcp_center/servers/nmap_mcp | Nmap扫描IP |
-| 12136 | [file_transfer_mcp](#file_transfer_mcp) | mcp_center/servers/file_transfer_mcp | 文件传输/下载 |
-| 12145 | [systrace_mcp](#systrace_mcp) | mcp_center/servers/systrace/systrace_mcp | 开启MCP Server服务 |
-| 12146 | systrace_openapi_mcp | mcp_center/servers/systrace/systrace_mcp | 开启OpenAPI Server服务 |
-| 12147 | [euler-copilot-tune_mcp](#euler-copilot-tune_mcp)| mcp_center/servers/euler-copilot-tune_mcp | 调优MCP服务 |
-| 12202 | [lscpu_mcp](#lscpu_mcp) | mcp_center/servers/lscpu_mcp | CPU架构等静态信息收集 |
-| 12203 | [numa_topo_mcp](#numa_topo_mcp) | mcp_center/servers/numa_topo_mcp | 查询NUMA硬件拓扑与系统配置 |
-| 12204 | [numa_bind_proc_mcp](#numa_bind_proc_mcp) | mcp_center/servers/numa_bind_proc_mcp | 启动时绑定进程到指定NUMA节点 |
-| 12205 | [numa_rebind_proc_mcp](#numa_rebind_proc_mcp) | mcp_center/servers/numa_rebind_proc_mcp | 修改已启动进程的NUMA绑定 |
-| 12206 | [numa_bind_docker_mcp](#numa_bind_docker_mcp) | mcp_center/servers/numa_bind_docker_mcp | 为Docker容器配置NUMA绑定 |
-| 12208 | [numa_perf_compare_mcp](#numa_perf_compare_mcp) | mcp_center/servers/numa_perf_compare_mcp | 用NUMA绑定控制测试变量 |
-| 12209 | [numa_diagnose_mcp](#numa_diagnose_mcp) | mcp_center/servers/numa_diagnose_mcp | 用NUMA绑定定位硬件问题 |
-| 12210 | [numastat_mcp](#numastat_mcp) | mcp_center/servers/numastat_mcp | 查看系统整体NUMA内存访问状态 |
-| 12211 | [numa_cross_node_mcp](#numa_cross_node_mcp) | mcp_center/servers/numa_cross_node_mcp | 定位跨节点内存访问过高的进程 |
-| 12214 | [numa_container_mcp](#numa_container_mcp) | mcp_center/servers/numa_container_mcp | 监控Docker容器的NUMA内存访问 |
-| 12216 | [hotspot_trace_mcp](#hotspot_trace_mcp) | mcp_center/servers/hotspot_trace_mcp | 快速定位系统/进程的CPU性能瓶颈 |
-| 12217 | [cache_miss_audit_mcp](#cache_miss_audit_mcp) | mcp_center/servers/cache_miss_audit_mcp | 定位CPU缓存失效导致的性能损耗 |
-| 12218 | [func_timing_trace_mcp](#func_timing_trace_mcp) | mcp_center/servers/func_timing_trace_mcp | 精准测量函数执行时间(含调用栈) |
-| 12219 | [strace_syscall_mcp](#strace_syscall_mcp) | mcp_center/servers/strace_syscall_mcp | 排查不合理的系统调用(高频/耗时) |
-| 12220 | [perf_interrupt_mcp](#perf_interrupt_mcp) | mcp_center/servers/perf_interrupt_mcp | 定位高频中断导致的CPU占用 |
-| 12222 | [flame_graph_mcp](#flame_graph_mcp) | mcp_center/servers/flame_graph_mcp | 火焰图生成:可视化展示性能瓶颈 |
-| 13100 | [free_mcp](#free_mcp) | mcp_center/servers/free_mcp | 获取系统内存整体状态 |
-| 13101 | [vmstat_mcp](#vmstat_mcp) | mcp_center/servers/vmstat_mcp | 系统资源交互瓶颈信息采集 |
-| 13102 | [sar_mcp](#sar_mcp) | mcp_center/servers/sar_mcp | 系统资源监控与故障诊断 |
-| 13103 | [sync_mcp](#sync_mcp) | mcp_center/servers/sync_mcp | 内存缓冲区数据写入磁盘 |
-| 13104 | [swapon_mcp](#swapon_mcp) | mcp_center/servers/swapon_mcp | 查看swap设备状态 |
-| 13105 | [swapoff_mcp](#swapoff_mcp) | mcp_center/servers/swapoff_mcp | swap设备停用 |
-| 13106 | [fallocate_mcp](#fallocate_mcp) | mcp_center/servers/fallocate_mcp | 临时创建并启用swap文件 |
-| 13107 | [find_mcp](#find_mcp) | mcp_center/servers/find_mcp | 文件查找 |
-| 13108 | [touch_mcp](#touch_mcp) | mcp_center/servers/touch_mcp | 文件创建与时间校准 |
-| 13109 | [mkdir_mcp](#mkdir_mcp) | mcp_center/servers/mkdir_mcp | 文件夹创建 |
-| 13110 | [rm_mcp](#rm_mcp) | mcp_center/servers/rm_mcp | 文件删除 |
-| 13111 | [mv_mcp](#mv_mcp) | mcp_center/servers/mv_mcp | 文件移动或重命名 |
-| 13112 | [ls_mcp](#ls_mcp) | mcp_center/servers/ls_mcp | 查看目录内容 |
-| 13113 | [head_mcp](#head_mcp) | mcp_center/servers/head_mcp | 文件开头内容查看工具 |
-| 13114 | [tail_mcp](#tail_mcp) | mcp_center/servers/tail_mcp | 文件末尾内容查看工具 |
-| 13115 | [cat_mcp](#cat_mcp) | mcp_center/servers/cat_mcp | 文件内容查看工具 |
-| 13116 | [chown_mcp](#chown_mcp) | mcp_center/servers/chown_mcp | 文件所有者修改工具 |
-| 13117 | [chmod_mcp](#chmod_mcp) | mcp_center/servers/chmod_mcp | 文件权限修改工具 |
-| 13118 | [tar_mcp](#tar_mcp) | mcp_center/servers/tar_mcp | 文件压缩解压工具 |
-| 13119 | [zip_mcp](#zip_mcp) | mcp_center/servers/zip_mcp | 文件压缩解压工具 |
-| 13120 | [grep_mcp](#grep_mcp) | mcp_center/servers/grep_mcp | 文件内容搜索工具 |
-| 13121 | [sed_mcp](#sed_mcp) | mcp_center/servers/sed_mcp | 文本处理工具 |
-| 13125 | [echo_mcp](#echo_mcp) | mcp_center/servers/echo_mcp | 文本写入工具 |
+| 端口号 | 服务名称 | 目录路径 | 简介 |
+|--------|----------|----------|------|
+| 12100 | [remote_info_mcp](#remote_info_mcp) | mcp_center/servers/remote_info_mcp | 获取端点信息 |
+| 12101 | [shell_generator_mcp](#shell_generator_mcp) | mcp_center/servers/shell_generator_mcp | 生成 & 执行 shell 命令 |
+| 12110 | [top_mcp](#top_mcp) | mcp_center/servers/top_mcp | 获取系统负载信息 |
+| 12111 | [kill_mcp](#kill_mcp) | mcp_center/servers/kill_mcp | 控制进程 & 查看进程信号量含义 |
+| 12112 | [nohup_mcp](#nohup_mcp) | mcp_center/servers/nohup_mcp | 后台执行进程 |
+| 12113 | [strace_mcp](#strace_mcp) | mcp_center/servers/strace_mcp | 跟踪进程信息,可用于异常情况分析 |
+| 12114 | [nvidia_mcp](#nvidia_mcp) | mcp_center/servers/nvidia_mcp | GPU 负载信息查询 |
+| 12115 | [npu_mcp](#npu_mcp) | mcp_center/servers/npu_mcp | NPU 的查询和控制 |
+| 12116 | [iftop_mcp](#iftop_mcp) | mcp_center/servers/iftop_mcp | 网络流量监控 |
+| 12117 | [nload_mcp](#nload_mcp) | mcp_center/servers/nload_mcp | Nload 带宽监控 |
+| 12118 | [netstat_mcp](#netstat_mcp) | mcp_center/servers/netstat_mcp | netstat 网络连接监控 |
+| 12119 | [lsof_mcp](#lsof_mcp) | mcp_center/servers/lsof_mcp | 快速排查文件占用冲突、网络连接异常及进程资源占用问题 |
+| 12120 | [ifconfig_mcp](#ifconfig_mcp) | mcp_center/servers/ifconfig_mcp | ifconfig 网络接口信息监控 |
+| 12121 | [ethtool_mcp](#ethtool_mcp) | mcp_center/servers/ethtool_mcp | ethtool 网卡信息查询,特性情况,网卡设置 |
+| 12122 | [tshark_mcp](#tshark_mcp) | mcp_center/servers/tshark_mcp | 捕获、显示和分析网络流量 |
+| 12125 | [file_content_tool_mcp](#file_content_tool_mcp) | mcp_center/servers/file_content_tool_mcp | 文件内容增删改查 |
+| 12130 | [firewalld_mcp](#firewalld_mcp) | mcp_center/servers/firewalld_mcp | Firewalld 网络防火墙管理工具 |
+| 12131 | [iptables_mcp](#iptables_mcp) | mcp_center/servers/iptables_mcp | iptables 防火墙管理工具 |
+| 12133 | [docker_mcp](#docker_mcp) | mcp_center/servers/docker_mcp | docker 工具 |
+| 12134 | [qemu_mcp](#qemu_mcp) | mcp_center/servers/qemu_mcp | Qemu 虚拟机管理工具 |
+| 12135 | [nmap_mcp](#nmap_mcp) | mcp_center/servers/nmap_mcp | Nmap 扫描 IP |
+| 12136 | [file_transfer_mcp](#file_transfer_mcp) | mcp_center/servers/file_transfer_mcp | 文件传输/下载 |
+| 12145 | [systrace_mcp](#systrace_mcp) | mcp_center/servers/systrace/systrace_mcp | 开启 MCP Server 服务 |
+| 12146 | systrace_openapi_mcp | mcp_center/servers/systrace/systrace_mcp | 开启 OpenAPI Server 服务 |
+| 12147 | [euler-copilot-tune_mcp](#euler-copilot-tune_mcp) | mcp_center/servers/euler-copilot-tune_mcp | 调优 MCP 服务 |
+| 12202 | [lscpu_mcp](#lscpu_mcp) | mcp_center/servers/lscpu_mcp | CPU 架构等静态信息收集 |
+| 12203 | [numa_topo_mcp](#numa_topo_mcp) | mcp_center/servers/numa_topo_mcp | 查询 NUMA 硬件拓扑与系统配置 |
+| 12204 | [numa_bind_proc_mcp](#numa_bind_proc_mcp) | mcp_center/servers/numa_bind_proc_mcp | 启动时绑定进程到指定 NUMA 节点 |
+| 12205 | [numa_rebind_proc_mcp](#numa_rebind_proc_mcp) | mcp_center/servers/numa_rebind_proc_mcp | 修改已启动进程的 NUMA 绑定 |
+| 12206 | [numa_bind_docker_mcp](#numa_bind_docker_mcp) | mcp_center/servers/numa_bind_docker_mcp | 为 Docker 容器配置 NUMA 绑定 |
+| 12208 | [numa_perf_compare_mcp](#numa_perf_compare_mcp) | mcp_center/servers/numa_perf_compare_mcp | 用 NUMA 绑定控制测试变量 |
+| 12209 | [numa_diagnose_mcp](#numa_diagnose_mcp) | mcp_center/servers/numa_diagnose_mcp | 用 NUMA 绑定定位硬件问题 |
+| 12210 | [numastat_mcp](#numastat_mcp) | mcp_center/servers/numastat_mcp | 查看系统整体 NUMA 内存访问状态 |
+| 12211 | [numa_cross_node_mcp](#numa_cross_node_mcp) | mcp_center/servers/numa_cross_node_mcp | 定位跨节点内存访问过高的进程 |
+| 12214 | [numa_container_mcp](#numa_container_mcp) | mcp_center/servers/numa_container_mcp | 监控 Docker 容器的 NUMA 内存访问 |
+| 12216 | [hotspot_trace_mcp](#hotspot_trace_mcp) | mcp_center/servers/hotspot_trace_mcp | 快速定位系统/进程的 CPU 性能瓶颈 |
+| 12217 | [cache_miss_audit_mcp](#cache_miss_audit_mcp) | mcp_center/servers/cache_miss_audit_mcp | 定位 CPU 缓存失效导致的性能损耗 |
+| 12218 | [func_timing_trace_mcp](#func_timing_trace_mcp) | mcp_center/servers/func_timing_trace_mcp | 精准测量函数执行时间(含调用栈) |
+| 12219 | [strace_syscall_mcp](#strace_syscall_mcp) | mcp_center/servers/strace_syscall_mcp | 排查不合理的系统调用(高频/耗时) |
+| 12220 | [perf_interrupt_mcp](#perf_interrupt_mcp) | mcp_center/servers/perf_interrupt_mcp | 定位高频中断导致的 CPU 占用 |
+| 12222 | [flame_graph_mcp](#flame_graph_mcp) | mcp_center/servers/flame_graph_mcp | 火焰图生成:可视化展示性能瓶颈 |
+| 13100 | [free_mcp](#free_mcp) | mcp_center/servers/free_mcp | 获取系统内存整体状态 |
+| 13101 | [vmstat_mcp](#vmstat_mcp) | mcp_center/servers/vmstat_mcp | 系统资源交互瓶颈信息采集 |
+| 13102 | [sar_mcp](#sar_mcp) | mcp_center/servers/sar_mcp | 系统资源监控与故障诊断 |
+| 13103 | [sync_mcp](#sync_mcp) | mcp_center/servers/sync_mcp | 内存缓冲区数据写入磁盘 |
+| 13104 | [swapon_mcp](#swapon_mcp) | mcp_center/servers/swapon_mcp | 查看 swap 设备状态 |
+| 13105 | [swapoff_mcp](#swapoff_mcp) | mcp_center/servers/swapoff_mcp | swap 设备停用 |
+| 13106 | [fallocate_mcp](#fallocate_mcp) | mcp_center/servers/fallocate_mcp | 临时创建并启用 swap 文件 |
+| 13107 | [find_mcp](#find_mcp) | mcp_center/servers/find_mcp | 文件查找 |
+| 13108 | [touch_mcp](#touch_mcp) | mcp_center/servers/touch_mcp | 文件创建与时间校准 |
+| 13109 | [mkdir_mcp](#mkdir_mcp) | mcp_center/servers/mkdir_mcp | 文件夹创建 |
+| 13110 | [rm_mcp](#rm_mcp) | mcp_center/servers/rm_mcp | 文件删除 |
+| 13111 | [mv_mcp](#mv_mcp) | mcp_center/servers/mv_mcp | 文件移动或重命名 |
+| 13112 | [ls_mcp](#ls_mcp) | mcp_center/servers/ls_mcp | 查看目录内容 |
+| 13113 | [head_mcp](#head_mcp) | mcp_center/servers/head_mcp | 文件开头内容查看工具 |
+| 13114 | [tail_mcp](#tail_mcp) | mcp_center/servers/tail_mcp | 文件末尾内容查看工具 |
+| 13115 | [cat_mcp](#cat_mcp) | mcp_center/servers/cat_mcp | 文件内容查看工具 |
+| 13116 | [chown_mcp](#chown_mcp) | mcp_center/servers/chown_mcp | 文件所有者修改工具 |
+| 13117 | [chmod_mcp](#chmod_mcp) | mcp_center/servers/chmod_mcp | 文件权限修改工具 |
+| 13118 | [tar_mcp](#tar_mcp) | mcp_center/servers/tar_mcp | 文件压缩解压工具 |
+| 13119 | [zip_mcp](#zip_mcp) | mcp_center/servers/zip_mcp | 文件压缩解压工具 |
+| 13120 | [grep_mcp](#grep_mcp) | mcp_center/servers/grep_mcp | 文件内容搜索工具 |
+| 13121 | [sed_mcp](#sed_mcp) | mcp_center/servers/sed_mcp | 文本处理工具 |
+| 13125 | [echo_mcp](#echo_mcp) | mcp_center/servers/echo_mcp | 文本写入工具 |
### 6.2 MCP_Server 详情
-本部分将针对核心MCP服务模块展开详细说明,通过“服务-工具-功能-参数-返回值”的结构化表格,清晰呈现每个MCP_Server的具体能力:包括其包含的工具列表、各工具的核心作用、调用时需传入的关键参数,以及执行后返回的结构化数据格式。旨在为运维人员提供“即查即用”的操作指南,确保能快速理解服务功能、正确配置参数、高效解析返回结果,满足日常运维、性能分析与故障排查的实际需求。
+本部分将针对核心 MCP 服务模块展开详细说明,通过“服务-工具-功能-参数-返回值”的结构化表格,清晰呈现每个 MCP_Server 的具体能力:包括其包含的工具列表、各工具的核心作用、调用时需传入的关键参数,以及执行后返回的结构化数据格式。旨在为运维人员提供“即查即用”的操作指南,确保能快速理解服务功能、正确配置参数、高效解析返回结果,满足日常运维、性能分析与故障排查的实际需求。
#### remote_info_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|-----------------|-----------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前k个**的进程信息,k支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认5) | 进程列表(含`pid`进程ID、`name`进程名称、`memory`内存使用量(MB)) |
-| | get_process_info_tool | 查询指定PID进程的**详细运行信息**,支持本地与远程进程信息获取 | - `host`:远程主机名/IP(本地查询可不填)
- `pid`:需查询的进程ID(必传,且为正整数) | 进程详细字典(含`status`状态、`create_time`创建时间、`cpu_times`CPU时间、`memory_info`内存信息、`open_files`打开文件列表、`connections`网络连接等) |
-| | change_name_to_pid_tool | 根据进程名称反向查询对应的**PID列表**,解决“已知进程名查ID”的场景需求 | - `host`:远程主机名/IP(本地查询可不填)
- `name`:需查询的进程名称(必传,不能为空) | 以空格分隔的PID字符串(如“1234 5678”) |
-| **remote_info_mcp** | get_cpu_info_tool | 采集目标设备的CPU硬件与使用状态信息,包括核心数、频率、核心使用率 | - `host`:远程主机名/IP(本地采集可不填) | CPU信息字典(含`physical_cores`物理核心数、`total_cores`逻辑核心数、`max_frequency`最大频率(MHz)、`cpu_usage`各核心使用率(%)等) |
-| | memory_anlyze_tool | 分析目标设备的内存使用情况,计算总内存、可用内存及使用率 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息字典(含`total`总内存(MB)、`available`可用内存(MB)、`used`已用内存(MB)、`percent`内存使用率(%)等) |
-| | get_disk_info_tool | 采集目标设备的磁盘分区信息与容量使用状态,过滤临时文件系统(tmpfs/devtmpfs) | - `host`:远程主机名/IP(本地采集可不填) | 磁盘列表(含`device`设备名、`mountpoint`挂载点、`fstype`文件系统类型、`total`总容量(GB)、`percent`磁盘使用率(%)等) |
-| | get_os_info_tool | 获取目标设备的操作系统类型与版本信息 | - `host`:远程主机名/IP(本地采集可不填) | 操作系统信息字符串(如“openEuler 22.03 LTS”) |
-| | get_network_info_tool | 采集目标设备的网络接口信息,包括IP地址、MAC地址、接口启用状态 | - `host`:远程主机名/IP(本地采集可不填) | 网络接口列表(含`interface`接口名、`ip_address`IP地址、`mac_address`MAC地址、`is_up`接口是否启用(布尔值)等) |
-| | write_report_tool | 将系统信息分析结果写入本地报告文件,自动生成带时间戳的文件路径 | - `report`:报告内容字符串(必传,不能为空) | 报告文件路径字符串(如“/reports/system_report_20240520_153000.txt”) |
-| | telnet_test_tool | 测试目标主机指定端口的Telnet连通性,验证端口开放状态 | - `host`:远程主机名/IP(必传)
- `port`:端口号(1-65535,必传) | 连通性结果(布尔值:`True`成功,`False`失败) |
-| | ping_test_tool | 测试目标主机的ICMP Ping连通性,验证主机网络可达性 | - `host`:远程主机名/IP(必传) | 连通性结果(布尔值:`True`成功,`False`失败) |
-| | get_dns_info_tool | 采集目标设备的DNS配置信息,包括DNS服务器列表与搜索域 | - `host`:远程主机名/IP(本地采集可不填) | DNS信息字典(含`nameservers`DNS服务器列表、`search`搜索域列表) |
-| | perf_data_tool | 采集目标设备的实时性能数据,支持“指定进程”或“全系统”性能监控 | - `host`:远程主机名/IP(本地采集可不填)
- `pid`:进程ID(全系统监控可不填) | 性能数据字典(含`cpu_usage`CPU使用率(%)、`memory_usage`内存使用率(%)、`io_counters`I/O统计信息) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前 k 个**的进程信息,k 支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认 5) | 进程列表(含 `pid` 进程 ID、`name` 进程名称、`memory` 内存使用量(MB)) |
+| | get_process_info_tool | 查询指定 PID 进程的**详细运行信息**,支持本地与远程进程信息获取 | - `host`:远程主机名/IP(本地查询可不填)
- `pid`:需查询的进程 ID(必传,且为正整数) | 进程详细字典(含 `status` 状态、`create_time` 创建时间、`cpu_times` CPU 时间、`memory_info` 内存信息、`open_files` 打开文件列表、`connections` 网络连接等) |
+| | change_name_to_pid_tool | 根据进程名称反向查询对应的**PID 列表**,解决"已知进程名查 ID"的场景需求 | - `host`:远程主机名/IP(本地查询可不填)
- `name`:需查询的进程名称(必传,不能为空) | 以空格分隔的 PID 字符串(如 "1234 5678") |
+| **remote_info_mcp** | get_cpu_info_tool | 采集目标设备的 CPU 硬件与使用状态信息,包括核心数、频率、核心使用率 | - `host`:远程主机名/IP(本地采集可不填) | CPU 信息字典(含 `physical_cores` 物理核心数、`total_cores` 逻辑核心数、`max_frequency` 最大频率(MHz)、`cpu_usage` 各核心使用率(%)等) |
+| | memory_anlyze_tool | 分析目标设备的内存使用情况,计算总内存、可用内存及使用率 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息字典(含 `total` 总内存(MB)、`available` 可用内存(MB)、`used` 已用内存(MB)、`percent` 内存使用率(%)等) |
+| | get_disk_info_tool | 采集目标设备的磁盘分区信息与容量使用状态,过滤临时文件系统(tmpfs/devtmpfs) | - `host`:远程主机名/IP(本地采集可不填) | 磁盘列表(含 `device` 设备名、`mountpoint` 挂载点、`fstype` 文件系统类型、`total` 总容量(GB)、`percent` 磁盘使用率(%)等) |
+| | get_os_info_tool | 获取目标设备的操作系统类型与版本信息 | - `host`:远程主机名/IP(本地采集可不填) | 操作系统信息字符串(如 "openEuler 22.03 LTS") |
+| | get_network_info_tool | 采集目标设备的网络接口信息,包括 IP 地址、MAC 地址、接口启用状态 | - `host`:远程主机名/IP(本地采集可不填) | 网络接口列表(含 `interface` 接口名、`ip_address` IP 地址、`mac_address` MAC 地址、`is_up` 接口是否启用(布尔值)等) |
+| | write_report_tool | 将系统信息分析结果写入本地报告文件,自动生成带时间戳的文件路径 | - `report`:报告内容字符串(必传,不能为空) | 报告文件路径字符串(如 "/reports/system_report_20240520_153000.txt") |
+| | telnet_test_tool | 测试目标主机指定端口的 Telnet 连通性,验证端口开放状态 | - `host`:远程主机名/IP(必传)
- `port`:端口号(1-65535,必传) | 连通性结果(布尔值:`True` 成功,`False` 失败) |
+| | ping_test_tool | 测试目标主机的 ICMP Ping 连通性,验证主机网络可达性 | - `host`:远程主机名/IP(必传) | 连通性结果(布尔值:`True` 成功,`False` 失败) |
+| | get_dns_info_tool | 采集目标设备的 DNS 配置信息,包括 DNS 服务器列表与搜索域 | - `host`:远程主机名/IP(本地采集可不填) | DNS 信息字典(含 `nameservers` DNS 服务器列表、`search` 搜索域列表) |
+| | perf_data_tool | 采集目标设备的实时性能数据,支持"指定进程"或"全系统"性能监控 | - `host`:远程主机名/IP(本地采集可不填)
- `pid`:进程 ID(全系统监控可不填) | 性能数据字典(含 `cpu_usage` CPU 使用率(%)、`memory_usage` 内存使用率(%)、`io_counters` I/O 统计信息) |
---
#### shell_generator_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------|-----------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **shell_generator** | cmd_generator_tool | 1. 系统信息采集:指定`host`则通过SSH获取远程主机信息(系统发行版、运行时间、根分区/内存使用、Top5内存进程),不指定则采集本机信息;2. LLM命令生成:将系统信息与用户需求传入大语言模型,生成符合场景的Linux shell命令;3. 格式校验:提取LLM返回的YAML格式命令块,输出有效命令字符串 | - `host`(可选):远程主机名/IP,需提前在配置文件配置主机IP、端口、用户名、密码,不提供则操作本机
- `goal`(必填):用户运维需求描述(如“查询根分区使用率”“查看内存占用最高的3个进程”) | 符合场景的Linux shell命令字符串(经格式校验后的有效命令) |
-| | cmd_executor_tool | 1. 多场景命令执行:支持本地或远程主机执行shell命令;2. 远程执行:通过SSH连接远程主机(基于配置文件信息),执行命令并捕获标准输出/错误输出,执行后关闭连接;3. 本地执行:通过`subprocess`模块执行命令,返回结果;4. 错误处理:命令执行出错(权限不足、命令不存在等)时,返回具体错误信息 | - `host`(可选):远程主机名/IP,需与配置文件信息匹配,不提供则操作本机
- `command`(必填):需执行的Linux shell命令字符串(建议由`cmd_generator_tool`生成) | 1. 命令执行成功:返回命令标准输出内容;2. 命令执行失败:返回具体错误信息(如“权限不足:Permission denied”“命令不存在:command not found”) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **shell_generator** | cmd_generator_tool | 1. 系统信息采集:指定 `host` 则通过 SSH 获取远程主机信息(系统发行版、运行时间、根分区/内存使用、Top5 内存进程),不指定则采集本机信息;2. LLM 命令生成:将系统信息与用户需求传入大语言模型,生成符合场景的 Linux shell 命令;3. 格式校验:提取 LLM 返回的 YAML 格式命令块,输出有效命令字符串 | - `host`(可选):远程主机名/IP,需提前在配置文件配置主机 IP、端口、用户名、密码,不提供则操作本机
- `goal`(必填):用户运维需求描述(如"查询根分区使用率""查看内存占用最高的 3 个进程") | 符合场景的 Linux shell 命令字符串(经格式校验后的有效命令) |
+| | cmd_executor_tool | 1. 多场景命令执行:支持本地或远程主机执行 shell 命令;2. 远程执行:通过 SSH 连接远程主机(基于配置文件信息),执行命令并捕获标准输出/错误输出,执行后关闭连接;3. 本地执行:通过 `subprocess` 模块执行命令,返回结果;4. 错误处理:命令执行出错(权限不足、命令不存在等)时,返回具体错误信息 | - `host`(可选):远程主机名/IP,需与配置文件信息匹配,不提供则操作本机
- `command`(必填):需执行的 Linux shell 命令字符串(建议由 `cmd_generator_tool` 生成) | 1. 命令执行成功:返回命令标准输出内容;2. 命令执行失败:返回具体错误信息(如"权限不足:Permission denied""命令不存在:command not found") |
---
#### top_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **top_mcp** | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前k个**的进程信息,k支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认5) | 进程列表(含`pid`进程ID、`name`进程名称、`memory`内存使用量(MB)) |
-| | top_servers_tool | 通过`top`命令获取指定目标(本地/远程服务器)的负载信息,涵盖CPU、内存、磁盘、网络及进程状态,为运维、性能分析和故障排查提供数据支持 | - `host`:远程主机名/IP(本地采集可不填)
- `dimensions`:需采集的维度(可选值:cpu、memory、disk、network)
- `include_processes`:是否包含进程信息(布尔值)
- `top_n`:需返回的进程数量(整数) | - `server_info`:服务器基本信息
- `metrics`:请求维度的统计结果(如CPU使用率、内存占用率)
- `processes`:进程列表(仅`include_processes`=True时返回)
- `error`:错误信息(如连接失败,无错误则为null) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **top_mcp** | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前 k 个**的进程信息,k 支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认 5) | 进程列表(含 `pid` 进程 ID、`name` 进程名称、`memory` 内存使用量(MB)) |
+| | top_servers_tool | 通过 `top` 命令获取指定目标(本地/远程服务器)的负载信息,涵盖 CPU、内存、磁盘、网络及进程状态,为运维、性能分析和故障排查提供数据支持 | - `host`:远程主机名/IP(本地采集可不填)
- `dimensions`:需采集的维度(可选值:cpu、memory、disk、network)
- `include_processes`:是否包含进程信息(布尔值)
- `top_n`:需返回的进程数量(整数) | - `server_info`:服务器基本信息
- `metrics`:请求维度的统计结果(如 CPU 使用率、内存占用率)
- `processes`:进程列表(仅 `include_processes`=True 时返回)
- `error`:错误信息(如连接失败,无错误则为 null) |
---
#### kill_mcp
-| 工具名称 | 工具功能 | 核心输入参数 | 关键返回内容 |
-| ---- | ---- | ---- | ---- |
-| `kill_process` | 通过`kill`指令发送信号终止进程(支持本地/远程,默认SIGTERM(15)) | - `pid`:需终止的进程PID(正整数,必填)
- `signal`:信号量(整数,可选,常用值:9(SIGKILL)、15(SIGTERM))
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为`localhost`)
- `pid`:被操作的进程PID
- `signal`:发送的信号量编号 |
-| `pause_process` | 通过`kill`指令发送`SIGSTOP`信号暂停进程(支持本地/远程) | - `pid`:需暂停的进程PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为`localhost`)
- `pid`:被暂停的进程PID |
-| `resume_process` | 通过`kill`指令发送`SIGCONT`信号恢复进程(支持本地/远程) | - `pid`:需恢复的进程PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为`localhost`)
- `pid`:被恢复的进程PID |
-| `check_process_status` | 检查本地或远程进程是否存在及名称信息 | - `pid`:需检查的进程PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:查询是否成功(布尔值)
- `message`:查询结果描述(字符串)
- `data`:包含进程状态的字典
- `host`:查询的主机名/IP(本地为`localhost`)
- `pid`:查询的进程PID
- `exists`:进程是否存在(布尔值)
- `name`:进程名称(字符串,进程不存在时为空) |
-| `get_kill_signals` | 查看本地或远程服务器的`kill`信号量含义及功能说明 | - `host`:远程主机名/IP(字符串,本地查询可不填,需与配置文件匹配) | - `success`:查询是否成功(布尔值)
- `message`:查询结果描述(字符串)
- `data`:包含信号量信息的字典
- `host`:查询的主机名/IP(本地为`localhost`)
- `signals`:信号量列表,每个元素包含:
- `number`:信号编号(整数)
- `name`:信号名称(如`SIGTERM`)
- `description`:信号功能说明 |
+| MCP_Server 名称 | 工具名称 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|----------|----------|--------------|--------------|
+| **kill_mcp** | `kill_process` | 通过 `kill` 指令发送信号终止进程(支持本地/远程,默认 SIGTERM(15)) | - `pid`:需终止的进程 PID(正整数,必填)
- `signal`:信号量(整数,可选,常用值:9(SIGKILL)、15(SIGTERM))
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为 `localhost`)
- `pid`:被操作的进程 PID
- `signal`:发送的信号量编号 |
+| | `pause_process` | 通过 `kill` 指令发送 `SIGSTOP` 信号暂停进程(支持本地/远程) | - `pid`:需暂停的进程 PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为 `localhost`)
- `pid`:被暂停的进程 PID |
+| | `resume_process` | 通过 `kill` 指令发送 `SIGCONT` 信号恢复进程(支持本地/远程) | - `pid`:需恢复的进程 PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串)
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP(本地为 `localhost`)
- `pid`:被恢复的进程 PID |
+| | `check_process_status` | 检查本地或远程进程是否存在及名称信息 | - `pid`:需检查的进程 PID(正整数,必填)
- `host`:远程主机名/IP(字符串,本地操作可不填,需与配置文件匹配) | - `success`:查询是否成功(布尔值)
- `message`:查询结果描述(字符串)
- `data`:包含进程状态的字典
- `host`:查询的主机名/IP(本地为 `localhost`)
- `pid`:查询的进程 PID
- `exists`:进程是否存在(布尔值)
- `name`:进程名称(字符串,进程不存在时为空) |
+| | `get_kill_signals` | 查看本地或远程服务器的 `kill` 信号量含义及功能说明 | - `host`:远程主机名/IP(字符串,本地查询可不填,需与配置文件匹配) | - `success`:查询是否成功(布尔值)
- `message`:查询结果描述(字符串)
- `data`:包含信号量信息的字典
- `host`:查询的主机名/IP(本地为 `localhost`)
- `signals`:信号量列表,每个元素包含:
- `number`:信号编号(整数)
- `name`:信号名称(如 `SIGTERM`)
- `description`:信号功能说明 |
---
#### ls_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|------------------|------------------------------------------------------------------------------|--------------------|
-| **ls_mcp** | ls_collect_tool | 列出目录内容 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:目标文件/目录 | 目标目录内容的列表 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **ls_mcp** | ls_collect_tool | 列出目录内容 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:目标文件/目录 | 目标目录内容的列表 |
---
#### lscpu_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------| ------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| **lscpu_mcp** | lscpu_info_tool | 使用 `lscpu` 命令获取本地或远程主机的 CPU 架构及核心静态信息 | - `host`:远程主机名/IP(若不提供则获取本机信息) | `architecture`:CPU 架构(如 x86\_64)、`cpus_total`:CPU 总数量、`model_name`:CPU 型号名称、`cpu_max_mhz`:CPU 最大频率 (MHz)、`vulnerabilities`:常见安全漏洞的缓解状态字典 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **lscpu_mcp** | lscpu_info_tool | 使用 `lscpu` 命令获取本地或远程主机的 CPU 架构及核心静态信息 | - `host`:远程主机名/IP(若不提供则获取本机信息) | `architecture`:CPU 架构(如 x86\_64)、`cpus_total`:CPU 总数量、`model_name`:CPU 型号名称、`cpu_max_mhz`:CPU 最大频率 (MHz)、`vulnerabilities`:常见安全漏洞的缓解状态字典 |
---
#### mkdir_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|----------------------------------------------------------|------------------------------------------------------------------------------|----------------------------|
-| **mkdir_mcp** | mkdir_collect_tool | 进行目录创建、支持批量创建、设置权限、递归创建多级目录 | - `host`:远程主机名/IP(本地采集可不填)
- `dir`:创建目录名 | 布尔值,表示mkdir操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **mkdir_mcp** | mkdir_collect_tool | 进行目录创建、支持批量创建、设置权限、递归创建多级目录 | - `host`:远程主机名/IP(本地采集可不填)
- `dir`:创建目录名 | 布尔值,表示 mkdir 操作是否成功 |
---
#### mv_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **mv_mcp** | mv_collect_tool | 移动或重命名文件/目录 | - `host`:远程主机名/IP(本地采集可不填)
- `source`:源文件或目录
- `target`:目标文件或目录 | 布尔值,表示mv操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **mv_mcp** | mv_collect_tool | 移动或重命名文件/目录 | - `host`:远程主机名/IP(本地采集可不填)
- `source`:源文件或目录
- `target`:目标文件或目录 | 布尔值,表示 mv 操作是否成功 |
---
#### nohup_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|----------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **nohup_mcp** | run_with_nohup | 使用`nohup`在本地或远程服务器运行命令,支持后台执行 | - `command`:需执行的命令(字符串,必填)
- `host`:远程主机IP或hostname(本地执行可不填)
- `port`:SSH端口(默认22,远程执行时使用)
- `username`:SSH用户名(远程执行时必填)
- `password`:SSH密码(远程执行时必填)
- `output_file`:输出日志文件路径(可选,默认自动生成)
- `working_dir`:命令执行的工作目录(可选) | - `success`:操作是否成功(布尔值)
- `message`:执行结果描述(字符串)
- `pid`:进程ID(成功执行时返回)
- `output_file`:输出日志文件路径
- `command`:实际执行的命令
- `host`:执行命令的主机(本地为`localhost`) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **nohup_mcp** | run_with_nohup | 使用 `nohup` 在本地或远程服务器运行命令,支持后台执行 | - `command`:需执行的命令(字符串,必填)
- `host`:远程主机 IP 或 hostname(本地执行可不填)
- `port`:SSH 端口(默认 22,远程执行时使用)
- `username`:SSH 用户名(远程执行时必填)
- `password`:SSH 密码(远程执行时必填)
- `output_file`:输出日志文件路径(可选,默认自动生成)
- `working_dir`:命令执行的工作目录(可选) | - `success`:操作是否成功(布尔值)
- `message`:执行结果描述(字符串)
- `pid`:进程 ID(成功执行时返回)
- `output_file`:输出日志文件路径
- `command`:实际执行的命令
- `host`:执行命令的主机(本地为 `localhost`) |
---
#### perf_microarch_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------------|---------------------------|---------------------------------------------------------------------------------------|------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
-| **perf_microarch_mcp** | cache_miss_audit_tool | 通过 `perf stat -a -e cache-misses,cycles,instructions sleep 10` 采集整机的微架构指标,支持本地和远程执行 | - `host`:可选,远程主机名/IP,留空则采集本机 | `cache_misses`:缓存未命中次数
`cycles`:CPU 周期数
`instructions`:指令数
`ipc`:每周期指令数 (Instructions per Cycle)
`seconds`:采集时长(秒) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **perf_microarch_mcp** | cache_miss_audit_tool | 通过 `perf stat -a -e cache-misses,cycles,instructions sleep 10` 采集整机的微架构指标,支持本地和远程执行 | - `host`:可选,远程主机名/IP,留空则采集本机 | `cache_misses`:缓存未命中次数
`cycles`:CPU 周期数
`instructions`:指令数
`ipc`:每周期指令数 (Instructions per Cycle)
`seconds`:采集时长(秒) |
---
#### cache_miss_audit_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------------|---------------------------|---------------------------------------------------------------------------------------|------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
-| **cache_miss_audit_mcp** | cache_miss_audit_tool | 通过 `perf stat -a -e cache-misses,cycles,instructions sleep 10` 采集整机的微架构指标,支持本地和远程执行 | - `host`:可选,远程主机名/IP,留空则采集本机 | `cache_miss`:缓存未命中次数
`cycles`:CPU 周期数
`instructions`:指令数
`ipc`:每周期指令数 (Instructions per Cycle)
`seconds`:采集时长(秒) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **cache_miss_audit_mcp** | cache_miss_audit_tool | 通过 `perf stat -a -e cache-misses,cycles,instructions sleep 10` 采集整机的微架构指标,支持本地和远程执行 | - `host`:可选,远程主机名/IP,留空则采集本机 | `cache_miss`:缓存未命中次数
`cycles`:CPU 周期数
`instructions`:指令数
`ipc`:每周期指令数 (Instructions per Cycle)
`seconds`:采集时长(秒) |
---
#### cat_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|------------------|------------------------------------------------------------------------------|--------------------|
-| **cat_mcp** | cat_file_view_tool | 快速查看文件内容 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:查看的文件路径 | 文件内容字符串 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **cat_mcp** | cat_file_view_tool | 快速查看文件内容 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:查看的文件路径 | 文件内容字符串 |
---
#### chmod_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **chmod_mcp** | chmod_change_mode_tool | 修改文件或目录的权限 | - `host`:远程主机名/IP(本地操作可不填)
- `mode`:权限模式(如755、644等)
- `file`:目标文件或目录路径 | 布尔值,表示操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **chmod_mcp** | chmod_change_mode_tool | 修改文件或目录的权限 | - `host`:远程主机名/IP(本地操作可不填)
- `mode`:权限模式(如 755、644 等)
- `file`:目标文件或目录路径 | 布尔值,表示操作是否成功 |
---
#### chown_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|---------------------------|------------------------------|------------------------------------------------------------------------------|----------------------------|
-| **chown_mcp** | chown_change_owner_tool | 修改文件或目录的所有者和所属组 | - `host`:远程主机名/IP(本地操作可不填)
- `owner_group`:文件所有者和文件关联组
- `file`:要修改的目标文件 | 布尔值,表示操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **chown_mcp** | chown_change_owner_tool | 修改文件或目录的所有者和所属组 | - `host`:远程主机名/IP(本地操作可不填)
- `owner_group`:文件所有者和文件关联组
- `file`:要修改的目标文件 | 布尔值,表示操作是否成功 |
---
#### disk_manager_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-----------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前k个**的进程信息,k支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认5) | 进程列表(含`pid`进程ID、`name`进程名称、`memory`内存使用量(MB)) |
-| | get_process_info_tool | 查询指定PID进程的**详细运行信息**,支持本地与远程进程信息获取 | - `host`:远程主机名/IP(本地查询可不填)
- `pid`:需查询的进程ID(必传,且为正整数) | 进程详细字典(含`status`状态、`create_time`创建时间、`cpu_times`CPU时间、`memory_info`内存信息、`open_files`打开文件列表、`connections`网络连接等) |
-| | change_name_to_pid_tool | 根据进程名称反向查询对应的**PID列表**,解决“已知进程名查ID”的场景需求 | - `host`:远程主机名/IP(本地查询可不填)
- `name`:需查询的进程名称(必传,不能为空) | 以空格分隔的PID字符串(如“1234 5678”) |
-| | get_cpu_info_tool | 采集目标设备的CPU硬件与使用状态信息,包括核心数、频率、核心使用率 | - `host`:远程主机名/IP(本地采集可不填) | CPU信息字典(含`physical_cores`物理核心数、`total_cores`逻辑核心数、`max_frequency`最大频率(MHz)、`cpu_usage`各核心使用率(%)等) |
-| | memory_anlyze_tool | 分析目标设备的内存使用情况,计算总内存、可用内存及使用率 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息字典(含`total`总内存(MB)、`available`可用内存(MB)、`used`已用内存(MB)、`percent`内存使用率(%)等) |
-| **disk_manager_mcp** | get_disk_info_tool | 采集目标设备的磁盘分区信息与容量使用状态,过滤临时文件系统(tmpfs/devtmpfs) | - `host`:远程主机名/IP(本地采集可不填) | 磁盘列表(含`device`设备名、`mountpoint`挂载点、`fstype`文件系统类型、`total`总容量(GB)、`percent`磁盘使用率(%)等) |
-| | get_os_info_tool | 获取目标设备的操作系统类型与版本信息,适配openEuler | - `host`:远程主机名/IP(本地采集可不填) | 操作系统信息字符串(如“openEuler 22.03 LTS”) |
-| | get_network_info_tool | 采集目标设备的网络接口信息,包括IP地址、MAC地址、接口启用状态 | - `host`:远程主机名/IP(本地采集可不填) | 网络接口列表(含`interface`接口名、`ip_address`IP地址、`mac_address`MAC地址、`is_up`接口是否启用(布尔值)等) |
-| | write_report_tool | 将系统信息分析结果写入本地报告文件,自动生成带时间戳的文件路径 | - `report`:报告内容字符串(必传,不能为空) | 报告文件路径字符串(如“/reports/system_report_20240520_153000.txt”) |
-| | telnet_test_tool | 测试目标主机指定端口的Telnet连通性,验证端口开放状态 | - `host`:远程主机名/IP(必传)
- `port`:端口号(1-65535,必传) | 连通性结果(布尔值:`True`成功,`False`失败) |
-| | ping_test_tool | 测试目标主机的ICMP Ping连通性,验证主机网络可达性 | - `host`:远程主机名/IP(必传) | 连通性结果(布尔值:`True`成功,`False`失败) |
-| | get_dns_info_tool | 采集目标设备的DNS配置信息,包括DNS服务器列表与搜索域 | - `host`:远程主机名/IP(本地采集可不填) | DNS信息字典(含`nameservers`DNS服务器列表、`search`搜索域列表) |
-| | perf_data_tool | 采集目标设备的实时性能数据,支持“指定进程”或“全系统”性能监控 | - `host`:远程主机名/IP(本地采集可不填)
- `pid`:进程ID(全系统监控可不填) | 性能数据字典(含`cpu_usage`CPU使用率(%)、`memory_usage`内存使用率(%)、`io_counters`I/O统计信息) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | top_collect_tool | 获取目标设备(本地/远程)中**内存占用排名前 k 个**的进程信息,k 支持自定义配置 | - `host`:远程主机名/IP(本地采集可不填)
- `k`:需获取的进程数量(默认 5) | 进程列表(含 `pid` 进程 ID、`name` 进程名称、`memory` 内存使用量(MB)) |
+| | get_process_info_tool | 查询指定 PID 进程的**详细运行信息**,支持本地与远程进程信息获取 | - `host`:远程主机名/IP(本地查询可不填)
- `pid`:需查询的进程 ID(必传,且为正整数) | 进程详细字典(含 `status` 状态、`create_time` 创建时间、`cpu_times` CPU 时间、`memory_info` 内存信息、`open_files` 打开文件列表、`connections` 网络连接等) |
+| | change_name_to_pid_tool | 根据进程名称反向查询对应的**PID 列表**,解决"已知进程名查 ID"的场景需求 | - `host`:远程主机名/IP(本地查询可不填)
- `name`:需查询的进程名称(必传,不能为空) | 以空格分隔的 PID 字符串(如 "1234 5678") |
+| | get_cpu_info_tool | 采集目标设备的 CPU 硬件与使用状态信息,包括核心数、频率、核心使用率 | - `host`:远程主机名/IP(本地采集可不填) | CPU 信息字典(含 `physical_cores` 物理核心数、`total_cores` 逻辑核心数、`max_frequency` 最大频率(MHz)、`cpu_usage` 各核心使用率(%)等) |
+| | memory_anlyze_tool | 分析目标设备的内存使用情况,计算总内存、可用内存及使用率 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息字典(含 `total` 总内存(MB)、`available` 可用内存(MB)、`used` 已用内存(MB)、`percent` 内存使用率(%)等) |
+| **disk_manager_mcp** | get_disk_info_tool | 采集目标设备的磁盘分区信息与容量使用状态,过滤临时文件系统(tmpfs/devtmpfs) | - `host`:远程主机名/IP(本地采集可不填) | 磁盘列表(含 `device` 设备名、`mountpoint` 挂载点、`fstype` 文件系统类型、`total` 总容量(GB)、`percent` 磁盘使用率(%)等) |
+| | get_os_info_tool | 获取目标设备的操作系统类型与版本信息,适配 openEuler | - `host`:远程主机名/IP(本地采集可不填) | 操作系统信息字符串(如 "openEuler 22.03 LTS") |
+| | get_network_info_tool | 采集目标设备的网络接口信息,包括 IP 地址、MAC 地址、接口启用状态 | - `host`:远程主机名/IP(本地采集可不填) | 网络接口列表(含 `interface` 接口名、`ip_address` IP 地址、`mac_address` MAC 地址、`is_up` 接口是否启用(布尔值)等) |
+| | write_report_tool | 将系统信息分析结果写入本地报告文件,自动生成带时间戳的文件路径 | - `report`:报告内容字符串(必传,不能为空) | 报告文件路径字符串(如 "/reports/system_report_20240520_153000.txt") |
+| | telnet_test_tool | 测试目标主机指定端口的 Telnet 连通性,验证端口开放状态 | - `host`:远程主机名/IP(必传)
- `port`:端口号(1-65535,必传) | 连通性结果(布尔值:`True` 成功,`False` 失败) |
+| | ping_test_tool | 测试目标主机的 ICMP Ping 连通性,验证主机网络可达性 | - `host`:远程主机名/IP(必传) | 连通性结果(布尔值:`True` 成功,`False` 失败) |
+| | get_dns_info_tool | 采集目标设备的 DNS 配置信息,包括 DNS 服务器列表与搜索域 | - `host`:远程主机名/IP(本地采集可不填) | DNS 信息字典(含 `nameservers` DNS 服务器列表、`search` 搜索域列表) |
+| | perf_data_tool | 采集目标设备的实时性能数据,支持"指定进程"或"全系统"性能监控 | - `host`:远程主机名/IP(本地采集可不填)
- `pid`:进程 ID(全系统监控可不填) | 性能数据字典(含 `cpu_usage` CPU 使用率(%)、`memory_usage` 内存使用率(%)、`io_counters` I/O 统计信息) |
---
#### echo_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **echo_mcp** | echo_write_to_file_tool | 使用echo命令将文本写入文件 | - `host`:远程主机名/IP(本地操作可不填)
- `text`:要写入的文本内容
- `file`:要写入的文件路径
- `options`:echo选项(可选),如"-n"不输出换行符等
- `mode`:写入模式,"w"表示覆盖写入,"a"表示追加写入,默认为"w" | 布尔值,表示写入操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **echo_mcp** | echo_write_to_file_tool | 使用 echo 命令将文本写入文件 | - `host`:远程主机名/IP(本地操作可不填)
- `text`:要写入的文本内容
- `file`:要写入的文件路径
- `options`:echo 选项(可选),如 "-n" 不输出换行符等
- `mode`:写入模式,"w" 表示覆盖写入,"a" 表示追加写入,默认为 "w" | 布尔值,表示写入操作是否成功 |
---
#### fallocate_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------|---------------------------|--------------------------|------------------------------------------------------------------------------|--------------------------------|
-| **fallocate_mcp** | fallocate_create_file_tool | 创建并启用swap文件(修正工具功能描述,与参数匹配) | - `host`:远程主机名/IP(本地采集可不填)
- `name`:swap空间对应的设备或文件路径
- `size`:创建的磁盘空间大小 | 布尔值,表示创建启用swap文件是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **fallocate_mcp** | fallocate_create_file_tool | 创建并启用 swap 文件(修正工具功能描述,与参数匹配) | - `host`:远程主机名/IP(本地采集可不填)
- `name`:swap 空间对应的设备或文件路径
- `size`:创建的磁盘空间大小 | 布尔值,表示创建启用 swap 文件是否成功 |
---
#### file_content_tool_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|-------------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | file_grep_tool | 通过`grep`命令搜索文件中匹配指定模式的内容(支持正则、大小写忽略等) | - `file_path`:目标文件路径(绝对路径,必填)
- `pattern`:搜索模式(支持正则,如"error",必填)
- `options`:`grep`可选参数(如"-n"显示行号、"-i"忽略大小写,可选)
- `host`:远程主机名/IP(默认`localhost`,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认`root`,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"本地文件搜索完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:匹配结果列表(每行一个匹配项) |
-| | file_sed_tool | 通过`sed`命令替换文件中匹配的内容(支持全局替换、原文件修改) | - `file_path`:目标文件路径(绝对路径,必填)
- `pattern`:替换模式(如"s/old/new/g",`g`表示全局替换,必填)
- `in_place`:是否直接修改原文件(布尔值,默认`False`,仅输出结果)
- `options`:`sed`可选参数(如"-i.bak"备份原文件,可选)
- `host`/`port`/`username`/`password`:同`file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"远程sed执行成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:替换后内容(`in_place=False`时返回) |
-| **file_content_tool_mcp** | file_awk_tool | 通过`awk`命令对文本文件进行高级处理(支持列提取、条件过滤) | - `file_path`:目标文件路径(绝对路径,必填)
- `script`:`awk`处理脚本(如"'{print $1,$3}'"提取1、3列,必填)
- `options`:`awk`可选参数(如"-F:"指定分隔符为冒号,可选)
- `host`/`port`/`username`/`password`:同`file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"本地awk处理成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:处理结果列表(每行一个结果项) |
-| | file_sort_tool | 通过`sort`命令对文本文件进行排序(支持按列、升序/降序) | - `file_path`:目标文件路径(绝对路径,必填)
- `options`:`sort`可选参数(如"-n"按数字排序、"-k2"按第2列排序、"-r"降序,可选)
- `output_file`:排序结果输出路径(可选,默认不保存到文件)
- `host`/`port`/`username`/`password`:同`file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"远程排序完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`/`output_file`:目标文件/输出文件路径
- `result`:排序结果列表(`output_file`为空时返回) |
-| | file_unique_tool | 通过`unique`命令对文本文件进行去重(支持统计重复次数) | - `file_path`:目标文件路径(绝对路径,必填)
- `options`:`unique`可选参数(如"-u"仅显示唯一行、"-c"统计重复次数,可选)
- `output_file`:去重结果输出路径(可选,默认不保存到文件)
- `host`/`port`/`username`/`password`:同`file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"本地去重完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`/`output_file`:目标文件/输出文件路径
- `result`:去重结果列表(`output_file`为空时返回) |
-| | file_echo_tool | 通过`echo`命令向文件写入内容(支持覆盖/追加模式) | - `content`:要写入的内容(如"Hello World",必填)
- `file_path`:目标文件路径(绝对路径,必填)
- `append`:是否追加内容(布尔值,默认`False`,覆盖原文件)
- `host`/`port`/`username`/`password`:同`file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"本地写入成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `action`:操作类型("overwrite"覆盖/"append"追加) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | file_grep_tool | 通过 `grep` 命令搜索文件中匹配指定模式的内容(支持正则、大小写忽略等) | - `file_path`:目标文件路径(绝对路径,必填)
- `pattern`:搜索模式(支持正则,如 "error",必填)
- `options`:`grep` 可选参数(如 "-n" 显示行号、"-i" 忽略大小写,可选)
- `host`:远程主机名/IP(默认 `localhost`,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 `root`,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "本地文件搜索完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:匹配结果列表(每行一个匹配项) |
+| | file_sed_tool | 通过 `sed` 命令替换文件中匹配的内容(支持全局替换、原文件修改) | - `file_path`:目标文件路径(绝对路径,必填)
- `pattern`:替换模式(如 "s/old/new/g",`g` 表示全局替换,必填)
- `in_place`:是否直接修改原文件(布尔值,默认 `False`,仅输出结果)
- `options`:`sed` 可选参数(如 "-i.bak" 备份原文件,可选)
- `host`/`port`/`username`/`password`:同 `file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "远程 sed 执行成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:替换后内容(`in_place=False` 时返回) |
+| **file_content_tool_mcp** | file_awk_tool | 通过 `awk` 命令对文本文件进行高级处理(支持列提取、条件过滤) | - `file_path`:目标文件路径(绝对路径,必填)
- `script`:`awk` 处理脚本(如 "'{print $1,$3}'" 提取 1、3 列,必填)
- `options`:`awk` 可选参数(如 "-F:" 指定分隔符为冒号,可选)
- `host`/`port`/`username`/`password`:同 `file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "本地 awk 处理成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `result`:处理结果列表(每行一个结果项) |
+| | file_sort_tool | 通过 `sort` 命令对文本文件进行排序(支持按列、升序/降序) | - `file_path`:目标文件路径(绝对路径,必填)
- `options`:`sort` 可选参数(如 "-n" 按数字排序、"-k2" 按第 2 列排序、"-r" 降序,可选)
- `output_file`:排序结果输出路径(可选,默认不保存到文件)
- `host`/`port`/`username`/`password`:同 `file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "远程排序完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`/`output_file`:目标文件/输出文件路径
- `result`:排序结果列表(`output_file` 为空时返回) |
+| | file_unique_tool | 通过 `unique` 命令对文本文件进行去重(支持统计重复次数) | - `file_path`:目标文件路径(绝对路径,必填)
- `options`:`unique` 可选参数(如 "-u" 仅显示唯一行、"-c" 统计重复次数,可选)
- `output_file`:去重结果输出路径(可选,默认不保存到文件)
- `host`/`port`/`username`/`password`:同 `file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "本地去重完成")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`/`output_file`:目标文件/输出文件路径
- `result`:去重结果列表(`output_file` 为空时返回) |
+| | file_echo_tool | 通过 `echo` 命令向文件写入内容(支持覆盖/追加模式) | - `content`:要写入的内容(如 "Hello World",必填)
- `file_path`:目标文件路径(绝对路径,必填)
- `append`:是否追加内容(布尔值,默认 `False`,覆盖原文件)
- `host`/`port`/`username`/`password`:同 `file_grep_tool` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "本地写入成功")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `action`:操作类型("overwrite" 覆盖/"append" 追加) |
---
#### find_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|------------------------------|------------------------------------------------------------------------------|------------------------------------------------|
-| | find_with_name_tool | 基于名称在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `name`:要找的文件名 | 查找到的文件列表(含`file`符合查找要求的具体文件路径) |
-| **find_mcp** | find_with_date_tool | 基于修改时间在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `date_condition`:修改时间条件(如"-mtime -1"表示1天内修改,补充参数使功能匹配) | 查找到的文件列表(含`file`符合查找要求的具体文件路径) |
-| | find_with_size_tool | 基于文件大小在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `size_condition`:文件大小条件(如"+10M"表示大于10MB,补充参数使功能匹配) | 查找到的文件列表(含`file`符合查找要求的具体文件路径) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | find_with_name_tool | 基于名称在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `name`:要找的文件名 | 查找到的文件列表(含 `file` 符合查找要求的具体文件路径) |
+| **find_mcp** | find_with_date_tool | 基于修改时间在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `date_condition`:修改时间条件(如 "-mtime -1" 表示 1 天内修改,补充参数使功能匹配) | 查找到的文件列表(含 `file` 符合查找要求的具体文件路径) |
+| | find_with_size_tool | 基于文件大小在指定目录下查找文件 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:指定查找的目录
- `size_condition`:文件大小条件(如 "+10M" 表示大于 10MB,补充参数使功能匹配) | 查找到的文件列表(含 `file` 符合查找要求的具体文件路径) |
---
#### flame_graph_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------|-----------------------| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| **flame_graph_mcp** | flame_graph | 基于 `perf.data` 生成 CPU 火焰图,用于性能分析(支持本地/远程) | - `host`:远程主机地址(可选)
- `perf_data_path`:perf.data 输入路径(必选)
- `output_path`:SVG 输出路径(默认:\~/cpu\_flamegraph.svg)
- `flamegraph_path`:FlameGraph 脚本路径(必选) | - `svg_path`:生成的火焰图文件路径
- `status`:生成状态(success / failure)
- `message`:状态信息 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **flame_graph_mcp** | flame_graph | 基于 `perf.data` 生成 CPU 火焰图,用于性能分析(支持本地/远程) | - `host`:远程主机地址(可选)
- `perf_data_path`:perf.data 输入路径(必选)
- `output_path`:SVG 输出路径(默认:\~/cpu\_flamegraph.svg)
- `flamegraph_path`:FlameGraph 脚本路径(必选) | - `svg_path`:生成的火焰图文件路径
- `status`:生成状态(success / failure)
- `message`:状态信息 |
---
#### free_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **free_mcp** | free_collect_tool | 获取目标设备(本地/远程)中内存整体状态信息 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息列表(含`total`系统内存总量(MB)、`used`系统已使用内存量(MB)、`free`空闲物理内存(MB)、`available`系统可分配内存(MB)) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **free_mcp** | free_collect_tool | 获取目标设备(本地/远程)中内存整体状态信息 | - `host`:远程主机名/IP(本地采集可不填) | 内存信息列表(含 `total` 系统内存总量(MB)、`used` 系统已使用内存量(MB)、`free` 空闲物理内存(MB)、`available` 系统可分配内存(MB)) |
---
#### func_timing_trace_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------| ------------------------------------------ | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| **func_timing_trace_mcp** | func_timing_trace_tool | 使用 `perf record -g` 采集目标进程的函数调用栈耗时,并解析热点函数 | - `pid`:目标进程 PID
- `host`:可选,远程主机 IP/域名;留空则采集本机 | `top_functions`:函数耗时分析结果,包含列表,每项包括:
• `function`:函数名
• `self_percent`:函数自身耗时占比
• `total_percent`:函数总耗时占比
• `call_stack`:函数调用栈 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **func_timing_trace_mcp** | func_timing_trace_tool | 使用 `perf record -g` 采集目标进程的函数调用栈耗时,并解析热点函数 | - `pid`:目标进程 PID
- `host`:可选,远程主机 IP/域名;留空则采集本机 | `top_functions`:函数耗时分析结果,包含列表,每项包括:
• `function`:函数名
• `self_percent`:函数自身耗时占比
• `total_percent`:函数总耗时占比
• `call_stack`:函数调用栈 |
---
#### grep_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|------------------------------------------------|
-| **grep_mcp** | grep_search_tool | 在文件中搜索指定模式的内容 | - `host`:远程主机名/IP(本地搜索可不填)
- `options`:grep选项(可选),如"-i"忽略大小写,"-n"显示行号等
- `pattern`:要搜索的模式(支持正则表达式)
- `file`:要搜索的文件路径 | 包含匹配行的字符串,如果没有找到匹配项则返回相应的提示信息 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **grep_mcp** | grep_search_tool | 在文件中搜索指定模式的内容 | - `host`:远程主机名/IP(本地搜索可不填)
- `options`:grep 选项(可选),如 "-i" 忽略大小写,"-n" 显示行号等
- `pattern`:要搜索的模式(支持正则表达式)
- `file`:要搜索的文件路径 | 包含匹配行的字符串,如果没有找到匹配项则返回相应的提示信息 |
---
#### head_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|--------------------|
-| **head_mcp** | head_file_view_tool | 快速查看文件开头部分内容 | - `host`:远程主机名/IP(本地采集可不填)
- `num`:查看文件开头行数,默认为10行
- `file`:查看的文件路径 | 文件内容字符串 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **head_mcp** | head_file_view_tool | 快速查看文件开头部分内容 | - `host`:远程主机名/IP(本地采集可不填)
- `num`:查看文件开头行数,默认为 10 行
- `file`:查看的文件路径 | 文件内容字符串 |
---
#### systrace_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|--------------------|
-| | slow_node_perception_tool | 检测指定task_id的机器性能是否发生劣化的工具 | - task_id:目标机器ip | 文件内容字符串 |
-| **systrace_mcp** | slow_node_detection_tool | 这是针对slow_node_perception_tool工具返回is_anomaly=True时调用的慢卡定界工具 | - performance_data: 感知工具返回的完整性能数据PerceptionResult | |
-| | generate_report_tool | 报告工具:生成最终Markdown格式报告 | - source_data 感知或定界的结果
- report_type 是否劣化 normal anomaly | |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | slow_node_perception_tool | 检测指定 task_id 的机器性能是否发生劣化的工具 | - task_id:目标机器 ip | 文件内容字符串 |
+| **systrace_mcp** | slow_node_detection_tool | 这是针对 slow_node_perception_tool 工具返回 is_anomaly=True 时调用的慢卡定界工具 | - performance_data: 感知工具返回的完整性能数据 PerceptionResult | |
+| | generate_report_tool | 报告工具:生成最终 Markdown 格式报告 | - source_data 感知或定界的结果
- report_type 是否劣化 normal anomaly | |
---
#### hotspot_trace_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| ---------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| **hotspot_trace_mcp** | hotspot_trace_tool | 使用 `perf record` 和 `perf report` 分析系统或指定进程的 CPU 性能瓶颈 | - `host`:远程主机名/IP(可选,不填则分析本机)
- `pid`:目标进程 ID(可选,不填则分析整机) | - `total_samples`:总样本数
- `event_count`:事件计数(如 cycles)
- `hot_functions`:热点函数列表(按 Children 百分比排序,包含函数名、库、符号类型和占比) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **hotspot_trace_mcp** | hotspot_trace_tool | 使用 `perf record` 和 `perf report` 分析系统或指定进程的 CPU 性能瓶颈 | - `host`:远程主机名/IP(可选,不填则分析本机)
- `pid`:目标进程 ID(可选,不填则分析整机) | - `total_samples`:总样本数
- `event_count`:事件计数(如 cycles)
- `hot_functions`:热点函数列表(按 Children 百分比排序,包含函数名、库、符号类型和占比) |
---
#### docker_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | manage_container_tool | 本地/远程主机容器全生命周期管理(含创建、启动、停止、删除、重启,支持端口映射与数据卷配置) | - `name`:容器名称(必填,唯一标识容器)
- `image`:镜像名称(创建时必填,格式如“nginx:latest”)
- `action`:操作类型(create/start/stop/delete/restart,必填)
- `ports`:端口映射(可选,格式“8080:80,443:443”)
- `volumes`:数据卷挂载(可选,格式“/host/path:/container/path:ro”)
- `restart_policy`:重启策略(no/always/on-failure/unless-stopped,默认“no”)
- `host`:远程主机名/IP(可选,默认“localhost”)
- `ssh_port`:SSH端口(可选,默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如“容器my-nginx start成功”)
- `data`:容器操作信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `action`:执行的操作类型
- `details`:操作详情(含容器ID、配置参数) |
-| | manage_image_tool | 本地/远程主机镜像管理(含拉取、删除、标签、推送,支持私有仓库认证) | - `image`:镜像名称(必填,格式如“nginx:latest”“registry.com/app:v1”)
- `action`:操作类型(pull/delete/tag/push/inspect,必填)
- `new_tag`:新标签(tag操作必填,格式如“my-app:v1”)
- `registry_auth`:仓库认证(可选,格式“username:password”,私有仓库使用)
- `host`:远程主机名/IP(可选,默认“localhost”)
- `ssh_port`:SSH端口(可选,默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如“镜像nginx:latest pull成功”)
- `data`:镜像信息字典
- `host`:操作的主机名/IP
- `image`:镜像名称
- `action`:执行的操作类型
- `inspect`:镜像详情(inspect操作返回,含架构、配置等) |
-| **docker_mcp** | container_data_operate_tool | 本地/远程主机容器数据交互(含容器导出、导入,及容器与本地文件拷贝) | - `name`:容器名称(必填,import时为镜像前缀)
- `action`:操作类型(export/import/cp,必填)
- `file_path`:文件路径(必填,cp时格式“src:dst”)
- `host`:远程主机名/IP(可选,默认“localhost”)
- `ssh_port`:SSH端口(可选,默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如“容器my-nginx export成功”)
- `data`:数据操作信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `action`:执行的操作类型
- `file_path`:操作的文件路径 |
-| | container_logs_tool | 本地/远程主机容器日志查询(支持实时跟踪、按时间/行数筛选) | - `name`:容器名称(必填)
- `tail`:日志行数(可选,默认100,0表示全部)
- `follow`:实时跟踪(可选,True/False,默认False)
- `since`:时间筛选(可选,格式“10m”“2024-01-01T00:00:00”)
- `host`:远程主机名/IP(可选,默认“localhost”)
- `ssh_port`:SSH端口(可选,默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如“成功获取my-nginx日志”)
- `data`:日志信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `logs`:日志内容(字符串格式)
- `filter`:筛选条件(tail/since) |
-| | list_containers_tool | 本地/远程主机容器列表查询(支持按运行状态、名称/镜像筛选) | - `all`:显示所有容器(可选,True/False,默认False仅显示运行中)
- `filter`:筛选条件(可选,格式“name=nginx,image=nginx:latest”)
- `host`:远程主机名/IP(可选,默认“localhost”)
- `ssh_port`:SSH端口(可选,默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如“成功获取本地运行中容器,共5个”)
- `data`:容器列表信息字典
- `host`:操作的主机名/IP
- `container_count`:容器总数
- `containers`:容器列表(含ID、名称、镜像、状态等)
- `filter`:筛选条件(all/name/image) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | manage_container_tool | 本地/远程主机容器全生命周期管理(含创建、启动、停止、删除、重启,支持端口映射与数据卷配置) | - `name`:容器名称(必填,唯一标识容器)
- `image`:镜像名称(创建时必填,格式如 "nginx:latest")
- `action`:操作类型(create/start/stop/delete/restart,必填)
- `ports`:端口映射(可选,格式 "8080:80,443:443")
- `volumes`:数据卷挂载(可选,格式 "/host/path:/container/path:ro")
- `restart_policy`:重启策略(no/always/on-failure/unless-stopped,默认 "no")
- `host`:远程主机名/IP(可选,默认 "localhost")
- `ssh_port`:SSH 端口(可选,默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "容器 my-nginx start 成功")
- `data`:容器操作信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `action`:执行的操作类型
- `details`:操作详情(含容器 ID、配置参数) |
+| | manage_image_tool | 本地/远程主机镜像管理(含拉取、删除、标签、推送,支持私有仓库认证) | - `image`:镜像名称(必填,格式如 "nginx:latest" "registry.com/app:v1")
- `action`:操作类型(pull/delete/tag/push/inspect,必填)
- `new_tag`:新标签(tag 操作必填,格式如 "my-app:v1")
- `registry_auth`:仓库认证(可选,格式 "username:password",私有仓库使用)
- `host`:远程主机名/IP(可选,默认 "localhost")
- `ssh_port`:SSH 端口(可选,默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "镜像 nginx:latest pull 成功")
- `data`:镜像信息字典
- `host`:操作的主机名/IP
- `image`:镜像名称
- `action`:执行的操作类型
- `inspect`:镜像详情(inspect 操作返回,含架构、配置等) |
+| **docker_mcp** | container_data_operate_tool | 本地/远程主机容器数据交互(含容器导出、导入,及容器与本地文件拷贝) | - `name`:容器名称(必填,import 时为镜像前缀)
- `action`:操作类型(export/import/cp,必填)
- `file_path`:文件路径(必填,cp 时格式 "src:dst")
- `host`:远程主机名/IP(可选,默认 "localhost")
- `ssh_port`:SSH 端口(可选,默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "容器 my-nginx export 成功")
- `data`:数据操作信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `action`:执行的操作类型
- `file_path`:操作的文件路径 |
+| | container_logs_tool | 本地/远程主机容器日志查询(支持实时跟踪、按时间/行数筛选) | - `name`:容器名称(必填)
- `tail`:日志行数(可选,默认 100,0 表示全部)
- `follow`:实时跟踪(可选,True/False,默认 False)
- `since`:时间筛选(可选,格式 "10m" "2024-01-01T00:00:00")
- `host`:远程主机名/IP(可选,默认 "localhost")
- `ssh_port`:SSH 端口(可选,默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 my-nginx 日志")
- `data`:日志信息字典
- `host`:操作的主机名/IP
- `container_name`:容器名称
- `logs`:日志内容(字符串格式)
- `filter`:筛选条件(tail/since) |
+| | list_containers_tool | 本地/远程主机容器列表查询(支持按运行状态、名称/镜像筛选) | - `all`:显示所有容器(可选,True/False,默认 False 仅显示运行中)
- `filter`:筛选条件(可选,格式 "name=nginx,image=nginx:latest")
- `host`:远程主机名/IP(可选,默认 "localhost")
- `ssh_port`:SSH 端口(可选,默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地运行中容器,共 5 个")
- `data`:容器列表信息字典
- `host`:操作的主机名/IP
- `container_count`:容器总数
- `containers`:容器列表(含 ID、名称、镜像、状态等)
- `filter`:筛选条件(all/name/image) |
---
#### file_transfer_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | http_download_tool | 通过 `curl` 或 `wget` 工具下载 HTTP/HTTPS/FTP 资源至本地,支持自动选择可用下载工具 | - `url`:下载资源链接(字符串,必填)
- `output_path`:本地保存路径(字符串,必填,格式如“/tmp/file.zip”)
- `tool`:下载工具(字符串,可选,值为“curl”/“wget”,默认自动选择可用工具) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如“文件已通过curl下载至/tmp/file.zip”)
- `data`:操作详情字典
- `url`:实际下载链接
- `output_path`:本地保存路径
- `file_size`:下载文件大小(整数,单位:字节)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
-| **file_transfer_mcp** | scp_transfer_tool | 通过 `scp` 协议实现本地与远程主机间文件/目录传输,支持递归传输目录 | - `src`:源路径(字符串,必填,本地路径如“/data/docs”,远程路径如“192.168.1.100:/remote/docs”)
- `dst`:目标路径(字符串,必填,格式同`src`)
- `host`:远程主机名/IP(字符串,必填,需与配置文件中主机信息匹配)
- `recursive`:是否递归传输目录(布尔值,可选,默认“false”,传输目录需设为“true”) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如“SCP传输成功:/data/docs -> 192.168.1.100:/remote/docs”)
- `data`:操作详情字典
- `src`:源路径
- `dst`:目标路径
- `file_count`:传输的文件总数(整数)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
-| | sftp_transfer_tool | 通过 `SFTP` 协议实现本地与远程主机间高级文件传输,支持自动创建目标目录 | - `operation`:操作类型(字符串,必填,值为“put”/“get”,“put”=本地到远程,“get”=远程到本地)
- `src`:源路径(字符串,必填,与`operation`匹配,如“put”时为本地路径)
- `dst`:目标路径(字符串,必填,与`operation`匹配,如“put”时为远程路径)
- `host`:远程主机名/IP(字符串,必填,需与配置文件中主机信息匹配)
- `create_dir`:是否自动创建目标目录(布尔值,可选,默认“true”) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如“SFTP put成功:/data/file.zip -> 192.168.1.100:/remote/file.zip”)
- `data`:操作详情字典
- `operation`:操作类型(“put”/“get”)
- `src`:源路径
- `dst`:目标路径
- `file_size`:传输文件总大小(整数,单位:字节)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | http_download_tool | 通过 `curl` 或 `wget` 工具下载 HTTP/HTTPS/FTP 资源至本地,支持自动选择可用下载工具 | - `url`:下载资源链接(字符串,必填)
- `output_path`:本地保存路径(字符串,必填,格式如 "/tmp/file.zip")
- `tool`:下载工具(字符串,可选,值为 "curl"/"wget",默认自动选择可用工具) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如 "文件已通过 curl 下载至 /tmp/file.zip")
- `data`:操作详情字典
- `url`:实际下载链接
- `output_path`:本地保存路径
- `file_size`:下载文件大小(整数,单位:字节)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
+| **file_transfer_mcp** | scp_transfer_tool | 通过 `scp` 协议实现本地与远程主机间文件/目录传输,支持递归传输目录 | - `src`:源路径(字符串,必填,本地路径如 "/data/docs",远程路径如 "192.168.1.100:/remote/docs")
- `dst`:目标路径(字符串,必填,格式同 `src`)
- `host`:远程主机名/IP(字符串,必填,需与配置文件中主机信息匹配)
- `recursive`:是否递归传输目录(布尔值,可选,默认 "false",传输目录需设为 "true") | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如 "SCP 传输成功:/data/docs -> 192.168.1.100:/remote/docs")
- `data`:操作详情字典
- `src`:源路径
- `dst`:目标路径
- `file_count`:传输的文件总数(整数)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
+| | sftp_transfer_tool | 通过 `SFTP` 协议实现本地与远程主机间高级文件传输,支持自动创建目标目录 | - `operation`:操作类型(字符串,必填,值为 "put"/"get","put"=本地到远程,"get"=远程到本地)
- `src`:源路径(字符串,必填,与 `operation` 匹配,如 "put" 时为本地路径)
- `dst`:目标路径(字符串,必填,与 `operation` 匹配,如 "put" 时为远程路径)
- `host`:远程主机名/IP(字符串,必填,需与配置文件中主机信息匹配)
- `create_dir`:是否自动创建目标目录(布尔值,可选,默认 "true") | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(字符串,如 "SFTP put 成功:/data/file.zip -> 192.168.1.100:/remote/file.zip")
- `data`:操作详情字典
- `operation`:操作类型("put"/"get")
- `src`:源路径
- `dst`:目标路径
- `file_size`:传输文件总大小(整数,单位:字节)
- `transfer_time`:传输耗时(浮点数,单位:秒) |
---
#### numa_bind_docker_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------| ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| **numa_bind_docker_mcp** | numa_bind_docker_tool | 使用 `numactl` 将指定 NUMA 绑定参数插入到镜像原有的 ENTRYPOINT / CMD 前,运行 Docker 容器(本地/远程) | - `image`:镜像名称
- `cpuset_cpus`:允许使用的 CPU 核心范围
- `cpuset_mems`:允许使用的内存节点
- `detach`:是否后台运行容器(默认 False)
- `host`:远程主机名/IP(可选) | - `status`:操作状态(success / error)
- `message`:操作结果信息
- `output`:命令的原始输出(如有) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_bind_docker_mcp** | numa_bind_docker_tool | 使用 `numactl` 将指定 NUMA 绑定参数插入到镜像原有的 ENTRYPOINT / CMD 前,运行 Docker 容器(本地/远程) | - `image`:镜像名称
- `cpuset_cpus`:允许使用的 CPU 核心范围
- `cpuset_mems`:允许使用的内存节点
- `detach`:是否后台运行容器(默认 False)
- `host`:远程主机名/IP(可选) | - `status`:操作状态(success / error)
- `message`:操作结果信息
- `output`:命令的原始输出(如有) |
---
#### numa_bind_proc_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------| ------------------------------------------------ | --------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
-| **numa_bind_proc_mcp** | numa_bind_proc_tool | 使用 `numactl` 命令在指定的 NUMA 节点和内存节点上运行程序(支持本地/远程执行) | - `host`:远程主机名/IP(本地可不填)
- `numa_node`:NUMA 节点编号(整数)
- `memory_node`:内存节点编号(整数)
- `program_path`:程序路径(必填) | `stdout`:程序标准输出、`stderr`:程序标准错误、`exit_code`:程序退出码 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_bind_proc_mcp** | numa_bind_proc_tool | 使用 `numactl` 命令在指定的 NUMA 节点和内存节点上运行程序(支持本地/远程执行) | - `host`:远程主机名/IP(本地可不填)
- `numa_node`:NUMA 节点编号(整数)
- `memory_node`:内存节点编号(整数)
- `program_path`:程序路径(必填) | `stdout`:程序标准输出、`stderr`:程序标准错误、`exit_code`:程序退出码 |
---
#### numa_container_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| -------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| **numa_container_mcp** | numa_container | 监控指定 Docker 容器的 NUMA 内存访问情况(支持本地/远程执行) | - `container_id`:要监控的容器 ID 或名称
- `host`:远程主机地址(可选,若为空则在本地执行) | - `status`:操作状态(success / error)
- `message`:操作结果信息
- `output`:NUMA 内存访问统计信息(包含每个 NUMA 节点的内存使用情况) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_container_mcp** | numa_container | 监控指定 Docker 容器的 NUMA 内存访问情况(支持本地/远程执行) | - `container_id`:要监控的容器 ID 或名称
- `host`:远程主机地址(可选,若为空则在本地执行) | - `status`:操作状态(success / error)
- `message`:操作结果信息
- `output`:NUMA 内存访问统计信息(包含每个 NUMA 节点的内存使用情况) |
---
#### numa_cross_node_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------------|---------------------------| ------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| **numa_cross_node_mcp** | numa_cross_node | 自动检测 NUMA 跨节点访问异常的进程(支持本地与远程主机) | - `host`:远程主机 IP/域名(可选,留空则检测本机)
- `threshold`:跨节点内存比例阈值(默认 30%) | `overall_conclusion`:整体结论(是否存在问题、严重程度、摘要),`anomaly_processes`:异常进程列表(包含 `pid`、`local_memory`、`remote_memory`、`cross_ratio`、`name`、`command`) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_cross_node_mcp** | numa_cross_node | 自动检测 NUMA 跨节点访问异常的进程(支持本地与远程主机) | - `host`:远程主机 IP/域名(可选,留空则检测本机)
- `threshold`:跨节点内存比例阈值(默认 30%) | `overall_conclusion`:整体结论(是否存在问题、严重程度、摘要),`anomaly_processes`:异常进程列表(包含 `pid`、`local_memory`、`remote_memory`、`cross_ratio`、`name`、`command`) |
---
#### numa_diagnose_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| --------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| **numa_diagnose_mcp** | numa_diagnose | 获取 NUMA 架构硬件监控信息,包括 CPU 实时频率、规格参数以及 NUMA 拓扑结构 | - `host`:远程主机地址(可选,不填则在本地执行) | - `real_time_frequencies`:各 CPU 核心实时频率 (MHz)
- `specifications`:CPU 规格信息(型号 / 频率范围 / NUMA 节点)
- `numa_topology`:NUMA 拓扑结构 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_diagnose_mcp** | numa_diagnose | 获取 NUMA 架构硬件监控信息,包括 CPU 实时频率、规格参数以及 NUMA 拓扑结构 | - `host`:远程主机地址(可选,不填则在本地执行) | - `real_time_frequencies`:各 CPU 核心实时频率 (MHz)
- `specifications`:CPU 规格信息(型号 / 频率范围 / NUMA 节点)
- `numa_topology`:NUMA 拓扑结构 |
---
#### numa_perf_compare_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------| ------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| **numa_perf_compare_mcp** | numa_perf_compare | 执行NUMA基准测试,支持本地绑定、跨节点绑定和不绑定三种策略 | - `benchmark`:基准测试可执行文件路径(如 `/root/mcp_center/stream`)
- `host`:远程主机名称或IP地址(可选) | `numa_nodes`:系统NUMA节点数量
`test_results`:包含三种绑定策略的测试结果
`timestamp`:执行时间
`error`:错误信息(如有) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_perf_compare_mcp** | numa_perf_compare | 执行 NUMA 基准测试,支持本地绑定、跨节点绑定和不绑定三种策略 | - `benchmark`:基准测试可执行文件路径(如 `/root/mcp_center/stream`)
- `host`:远程主机名称或 IP 地址(可选) | `numa_nodes`:系统 NUMA 节点数量
`test_results`:包含三种绑定策略的测试结果
`timestamp`:执行时间
`error`:错误信息(如有) |
---
#### numa_rebind_proc_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|------------------------|---------------------------| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
-| **numa_rebind_proc_mcp** | numa_rebind_proc_tool | 修改已运行进程的 NUMA 内存绑定,使用 migratepages 工具将进程的内存从一个 NUMA 节点迁移到另一个节点 | - `pid`:进程 ID
- `from_node`:当前内存所在的 NUMA 节点编号
- `to_node`:目标 NUMA 节点编号
- `host`:远程主机 IP 或名称(可选) | `status`:操作状态(success / error)
`message`:操作结果信息
`output`:命令的原始输出(如有) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_rebind_proc_mcp** | numa_rebind_proc_tool | 修改已运行进程的 NUMA 内存绑定,使用 migratepages 工具将进程的内存从一个 NUMA 节点迁移到另一个节点 | - `pid`:进程 ID
- `from_node`:当前内存所在的 NUMA 节点编号
- `to_node`:目标 NUMA 节点编号
- `host`:远程主机 IP 或名称(可选) | `status`:操作状态(success / error)
`message`:操作结果信息
`output`:命令的原始输出(如有) |
---
#### numa_topo_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| ------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| **numa_topo_mcp** | numa_topo_tool | 使用 numactl 获取本地或远程主机的 NUMA 拓扑信息 | - `host`:远程主机名称或 IP(可选,不填表示获取本机信息) | - `nodes_total`:总节点数
- `nodes`:节点信息列表,每个节点包含:`node_id`(节点 ID)、`cpus`(CPU 列表)、`size_mb`(内存大小 MB)、`free_mb`(空闲内存 MB) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numa_topo_mcp** | numa_topo_tool | 使用 numactl 获取本地或远程主机的 NUMA 拓扑信息 | - `host`:远程主机名称或 IP(可选,不填表示获取本机信息) | - `nodes_total`:总节点数
- `nodes`:节点信息列表,每个节点包含:`node_id`(节点 ID)、`cpus`(CPU 列表)、`size_mb`(内存大小 MB)、`free_mb`(空闲内存 MB) |
---
#### numastat_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| ------------------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| **numastat_mcp** | numastat_info_tool | 使用 `numastat` 命令获取本地或远程主机的 NUMA 统计信息 | - `host`:远程主机名称或 IP,若不提供则获取本机信息 | `numa_hit`: NUMA 命中次数、`numa_miss`: NUMA 未命中次数、`numa_foreign`: 外部访问次数、`interleave_hit`: 交错命中次数、`local_node`: 本地节点访问次数、`other_node`: 其他节点访问次数 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **numastat_mcp** | numastat_info_tool | 使用 `numastat` 命令获取本地或远程主机的 NUMA 统计信息 | - `host`:远程主机名称或 IP,若不提供则获取本机信息 | `numa_hit`: NUMA 命中次数、`numa_miss`: NUMA 未命中次数、`numa_foreign`: 外部访问次数、`interleave_hit`: 交错命中次数、`local_node`: 本地节点访问次数、`other_node`: 其他节点访问次数 |
---
#### nvidia_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|-------------------------------------------|------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
-| | nvidia_smi_status | 输出结构化 GPU 状态数据(JSON 友好) | - `host`:远程主机 IP/hostname(本地可不填)
- `port`:SSH 端口(默认 22)
- `username`/`password`:远程查询必填
- `gpu_index`:指定 GPU 索引(可选)
- `include_processes`:是否包含进程信息(默认 False) | - `success`:查询成功与否
- `message`:结果描述
- `data`:结构化数据,包含:
- `host`:主机地址
- `gpus`:GPU 列表(含索引、型号、利用率、显存等) |
-| **nvidia_mcp** | nvidia_smi_raw_table | 输出 `nvidia-smi` 原生表格(保留原始格式) | - `host`:远程主机 IP/hostname(本地可不填)
- `port`:SSH 端口(默认 22)
- `username`/`password`:远程查询必填 | - `success`:查询成功与否
- `message`:结果描述
- `data`:原始表格数据,包含:
- `host`:主机地址
- `raw_table`:`nvidia-smi` 原生表格字符串(含换行和格式) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | nvidia_smi_status | 输出结构化 GPU 状态数据(JSON 友好) | - `host`:远程主机 IP/hostname(本地可不填)
- `port`:SSH 端口(默认 22)
- `username`/`password`:远程查询必填
- `gpu_index`:指定 GPU 索引(可选)
- `include_processes`:是否包含进程信息(默认 False) | - `success`:查询成功与否
- `message`:结果描述
- `data`:结构化数据,包含:
- `host`:主机地址
- `gpus`:GPU 列表(含索引、型号、利用率、显存等) |
+| **nvidia_mcp** | nvidia_smi_raw_table | 输出 `nvidia-smi` 原生表格(保留原始格式) | - `host`:远程主机 IP/hostname(本地可不填)
- `port`:SSH 端口(默认 22)
- `username`/`password`:远程查询必填 | - `success`:查询成功与否
- `message`:结果描述
- `data`:原始表格数据,包含:
- `host`:主机地址
- `raw_table`:`nvidia-smi` 原生表格字符串(含换行和格式) |
---
#### perf_interrupt_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|--------------------|-------------------------| ---------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
| **perf_interrupt_mcp** | perf_interrupt_health_check | 检查系统中断统计信息,以定位高频中断导致的 CPU 占用 | - `host`:远程主机名称或 IP 地址,若不提供则获取本机信息 | 返回一个包含中断信息的列表,每个元素包含:`irq_number` 中断编号、`total_count` 总触发次数、`device` 设备名称、`cpu_distribution` 各 CPU 核心的中断分布、`interrupt_type` 中断类型 |
---
#### rm_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **rm_mcp** | rm_collect_tool | 对文件或文件夹进行删除 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:要进行删除的文件或文件夹路径 | 布尔值,表示rm操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **rm_mcp** | rm_collect_tool | 对文件或文件夹进行删除 | - `host`:远程主机名/IP(本地采集可不填)
- `path`:要进行删除的文件或文件夹路径 | 布尔值,表示 rm 操作是否成功 |
---
#### sar_mcp
-|MCP_Server名称|MCP_Tool列表|工具功能|核心输入参数|关键返回内容|
-|---|---|---|---|---|
-||sar_cpu_collect_tool|分析CPU使用的周期性规律|- `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数|采集指标列表:含`timestamp`采集时间点、`user`用户空间程序占用CPU的百分比、`nice`低优先级用户进程占用的CPU百分比、`system`内核空间程序占用CPU的百分比、`iowait`CPU等待磁盘I/O操作的时间百分比、`steal`虚拟化环境中其他虚拟机占用的CPU时间百分比、`idle`CPU空闲时间百分比|
-||sar_memory_collect_tool|分析内存资源使用的周期性规律|- `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数|采集指标列表:含`timestamp`采集时间点、`kbmemfree`物理空闲内存量、`kbavail`实际可用内存、`kbmemused`已使用的物理内存、`memused`已用内存占总物理内存的百分比、`kbbuffers`内核缓冲区(Buffer)占用的内存、`kbcached`内核缓存(Cache)占用的内存、`kbcommit`当前工作负载所需的总内存量、`commit`kbcommit占系统总可用内存百分比、`kbactive`活跃内存、`kbinact`非活跃内存、`kbdirty`等待写入磁盘的脏数据量|
-||sar_disk_collect_tool|分析磁盘IO使用的周期性规律|- `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数|采集指标列表:含`timestamp`采集时间点、`name`磁盘设备名称、`tps`每秒传输次数、`rkB_s`每秒读取的数据量、`wkB_s`每秒写入的数据量、`dkB_s`每秒丢弃的数据量、`areq-sz`平均每次I/O请求的数据大小、`aqu-sz`平均I/O请求队列长度、`await`平均每次I/O请求的等待时间、`util`设备带宽利用率|
-|**sar_mcp**|sar_network_collect_tool|分析网络流量的周期性规律|- `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数|采集指标列表:含`timestamp`采集时间点、`iface`网络接口名称、`rxpck_s`每秒接收的数据包数量、`txpck_s`每秒发送的数据包数量、`rxkB_s`每秒接收的数据量、`txkB_s`每秒发送的数据量、`rxcmp_s`每秒接收的压缩数据包数、`txcmp_s`每秒发送的压缩数据包数、`rxmcst_s`每秒接收的多播数据包数、`ifutil`网络接口带宽利用率|
-||sar_cpu_historicalinfo_collect_tool|进行历史状态分析,排查过去某时段cpu的性能问题|- `host`:远程主机名/IP(本地查询可不填)
- `file`:sar要分析的log文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点|采集指标列表:含`timestamp`采集时间点、`user`用户空间程序占用CPU的百分比、`nice`低优先级用户进程占用的CPU百分比、`system`内核空间程序占用CPU的百分比、`iowait`CPU等待磁盘I/O操作的时间百分比、`steal`虚拟化环境中其他虚拟机占用的CPU时间百分比、`idle`CPU空闲时间百分比|
-||sar_memory_historicalinfo_collect_tool|进行历史状态分析,排查过去某时段内存的性能问题|- `host`:远程主机名/IP(本地查询可不填)
- `file`:sar要分析的log文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点|采集指标列表:含`timestamp`采集时间点、`kbmemfree`物理空闲内存量、`kbavail`实际可用内存、`kbmemused`已使用的物理内存、`memused`已用内存占总物理内存的百分比、`kbbuffers`内核缓冲区(Buffer)占用的内存、`kbcached`内核缓存(Cache)占用的内存、`kbcommit`当前工作负载所需的总内存量、`commit`kbcommit占系统总可用内存百分比、`kbactive`活跃内存、`kbinact`非活跃内存、`kbdirty`等待写入磁盘的脏数据量|
-||sar_disk_historicalinfo_collect_tool|进行历史状态分析,排查过去某时段磁盘IO的性能问题|- `host`:远程主机名/IP(本地查询可不填)
- `file`:sar要分析的log文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点|采集指标列表:含`timestamp`采集时间点、`name`磁盘设备名称、`tps`每秒传输次数、`rkB_s`每秒读取的数据量、`wkB_s`每秒写入的数据量、`dkB_s`每秒丢弃的数据量、`areq-sz`平均每次I/O请求的数据大小、`aqu-sz`平均I/O请求队列长度、`await`平均每次I/O请求的等待时间、`util`设备带宽利用率|
-||sar_network_historicalinfo_collect_tool|进行历史状态分析,排查过去某时段网络的性能问题|- `host`:远程主机名/IP(本地查询可不填)
- `file`:sar要分析的log文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点|采集指标列表:含`timestamp`采集时间点、`iface`网络接口名称、`rxpck_s`每秒接收的数据包数量、`txpck_s`每秒发送的数据包数量、`rxkB_s`每秒接收的数据量、`txkB_s`每秒发送的数据量、`rxcmp_s`每秒接收的压缩数据包数、`txcmp_s`每秒发送的压缩数据包数、`rxmcst_s`每秒接收的多播数据包数、`ifutil`网络接口带宽利用率|
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | sar_cpu_collect_tool | 分析 CPU 使用的周期性规律 | - `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数 | 采集指标列表:含 `timestamp` 采集时间点、`user` 用户空间程序占用 CPU 的百分比、`nice` 低优先级用户进程占用的 CPU 百分比、`system` 内核空间程序占用 CPU 的百分比、`iowait` CPU 等待磁盘 I/O 操作的时间百分比、`steal` 虚拟化环境中其他虚拟机占用的 CPU 时间百分比、`idle` CPU 空闲时间百分比 |
+| | sar_memory_collect_tool | 分析内存资源使用的周期性规律 | - `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数 | 采集指标列表:含 `timestamp` 采集时间点、`kbmemfree` 物理空闲内存量、`kbavail` 实际可用内存、`kbmemused` 已使用的物理内存、`memused` 已用内存占总物理内存的百分比、`kbbuffers` 内核缓冲区(Buffer)占用的内存、`kbcached` 内核缓存(Cache)占用的内存、`kbcommit` 当前工作负载所需的总内存量、`commit` kbcommit 占系统总可用内存百分比、`kbactive` 活跃内存、`kbinact` 非活跃内存、`kbdirty` 等待写入磁盘的脏数据量 |
+| | sar_disk_collect_tool | 分析磁盘 IO 使用的周期性规律 | - `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数 | 采集指标列表:含 `timestamp` 采集时间点、`name` 磁盘设备名称、`tps` 每秒传输次数、`rkB_s` 每秒读取的数据量、`wkB_s` 每秒写入的数据量、`dkB_s` 每秒丢弃的数据量、`areq-sz` 平均每次 I/O 请求的数据大小、`aqu-sz` 平均 I/O 请求队列长度、`await` 平均每次 I/O 请求的等待时间、`util` 设备带宽利用率 |
+| **sar_mcp** | sar_network_collect_tool | 分析网络流量的周期性规律 | - `host`:远程主机名/IP(本地采集可不填)
- `interval`:监控的时间间隔
- `count`:监控次数 | 采集指标列表:含 `timestamp` 采集时间点、`iface` 网络接口名称、`rxpck_s` 每秒接收的数据包数量、`txpck_s` 每秒发送的数据包数量、`rxkB_s` 每秒接收的数据量、`txkB_s` 每秒发送的数据量、`rxcmp_s` 每秒接收的压缩数据包数、`txcmp_s` 每秒发送的压缩数据包数、`rxmcst_s` 每秒接收的多播数据包数、`ifutil` 网络接口带宽利用率 |
+| | sar_cpu_historicalinfo_collect_tool | 进行历史状态分析,排查过去某时段 cpu 的性能问题 | - `host`:远程主机名/IP(本地查询可不填)
- `file`:sar 要分析的 log 文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点 | 采集指标列表:含 `timestamp` 采集时间点、`user` 用户空间程序占用 CPU 的百分比、`nice` 低优先级用户进程占用的 CPU 百分比、`system` 内核空间程序占用 CPU 的百分比、`iowait` CPU 等待磁盘 I/O 操作的时间百分比、`steal` 虚拟化环境中其他虚拟机占用的 CPU 时间百分比、`idle` CPU 空闲时间百分比 |
+| | sar_memory_historicalinfo_collect_tool | 进行历史状态分析,排查过去某时段内存的性能问题 | - `host`:远程主机名/IP(本地查询可不填)
- `file`:sar 要分析的 log 文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点 | 采集指标列表:含 `timestamp` 采集时间点、`kbmemfree` 物理空闲内存量、`kbavail` 实际可用内存、`kbmemused` 已使用的物理内存、`memused` 已用内存占总物理内存的百分比、`kbbuffers` 内核缓冲区(Buffer)占用的内存、`kbcached` 内核缓存(Cache)占用的内存、`kbcommit` 当前工作负载所需的总内存量、`commit` kbcommit 占系统总可用内存百分比、`kbactive` 活跃内存、`kbinact` 非活跃内存、`kbdirty` 等待写入磁盘的脏数据量 |
+| | sar_disk_historicalinfo_collect_tool | 进行历史状态分析,排查过去某时段磁盘 IO 的性能问题 | - `host`:远程主机名/IP(本地查询可不填)
- `file`:sar 要分析的 log 文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点 | 采集指标列表:含 `timestamp` 采集时间点、`name` 磁盘设备名称、`tps` 每秒传输次数、`rkB_s` 每秒读取的数据量、`wkB_s` 每秒写入的数据量、`dkB_s` 每秒丢弃的数据量、`areq-sz` 平均每次 I/O 请求的数据大小、`aqu-sz` 平均 I/O 请求队列长度、`await` 平均每次 I/O 请求的等待时间、`util` 设备带宽利用率 |
+| | sar_network_historicalinfo_collect_tool | 进行历史状态分析,排查过去某时段网络的性能问题 | - `host`:远程主机名/IP(本地查询可不填)
- `file`:sar 要分析的 log 文件
- `starttime`:分析开始的时间点
- `endtime`:分析结束的时间点 | 采集指标列表:含 `timestamp` 采集时间点、`iface` 网络接口名称、`rxpck_s` 每秒接收的数据包数量、`txpck_s` 每秒发送的数据包数量、`rxkB_s` 每秒接收的数据量、`txkB_s` 每秒发送的数据量、`rxcmp_s` 每秒接收的压缩数据包数、`txcmp_s` 每秒发送的压缩数据包数、`rxmcst_s` 每秒接收的多播数据包数、`ifutil` 网络接口带宽利用率 |
---
#### sed_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **sed_mcp** | sed_text_replace_tool | 在文件中替换指定模式的文本 | - `host`:远程主机名/IP(本地操作可不填)
- `options`:sed选项(可选),如"-i"直接修改文件
- `pattern`:要替换的模式(支持正则表达式)
- `replacement`:替换后的文本
- `file`:要操作的文件路径 | 布尔值,表示操作是否成功 |
-| | sed_text_delete_tool | 删除文件中匹配模式的行 | - `host`:远程主机名/IP(本地操作可不填)
- `options`:sed选项(可选),如"-i"直接修改文件
- `pattern`:要删除的行的模式(支持正则表达式)
- `file`:要操作的文件路径 | 布尔值,表示操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **sed_mcp** | sed_text_replace_tool | 在文件中替换指定模式的文本 | - `host`:远程主机名/IP(本地操作可不填)
- `options`:sed 选项(可选),如 "-i" 直接修改文件
- `pattern`:要替换的模式(支持正则表达式)
- `replacement`:替换后的文本
- `file`:要操作的文件路径 | 布尔值,表示操作是否成功 |
+| | sed_text_delete_tool | 删除文件中匹配模式的行 | - `host`:远程主机名/IP(本地操作可不填)
- `options`:sed 选项(可选),如 "-i" 直接修改文件
- `pattern`:要删除的行的模式(支持正则表达式)
- `file`:要操作的文件路径 | 布尔值,表示操作是否成功 |
---
#### strace_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------------|--------------------------------------------|------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
-| | strace_track_file_process | 跟踪进程的文件操作和运行状态(如打开、读取、写入文件等) | - `pid`:目标进程PID(必填)
- `host`:远程主机IP/hostname(本地跟踪可不填)
- `port`:SSH端口(默认22)
- `username`/`password`:远程跟踪时必填
- `output_file`:日志路径(可选)
- `follow_children`:是否跟踪子进程(默认False)
- `duration`:跟踪时长(秒,可选) | - `success`:跟踪启动状态
- `message`:结果描述
- `strace_pid`:跟踪进程ID
- `output_file`:日志路径
- `target_pid`/`host`:目标进程及主机信息 |
-| **strace_mcp** | strace_check_permission_file| 排查进程的"权限不足"和"文件找不到"错误 | - `pid`:目标进程PID(必填)
- 远程参数(`host`/`port`/`username`/`password`)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认30秒) | - 基础状态信息(`success`/`message`等)
- `errors`:错误统计字典,包含:
- 权限不足错误详情
- 文件找不到错误详情 |
-| | strace_check_network | 诊断进程网络问题(连接失败、超时、DNS解析等) | - `pid`:目标进程PID(必填)
- 远程参数(同上)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认30秒)
- `trace_dns`:是否跟踪DNS调用(默认True) | - 基础状态信息
- `errors`:网络错误统计,包含:
- 连接被拒绝、超时等错误
- DNS解析失败详情(若启用) |
-| | strace_locate_freeze | 定位进程卡顿原因(IO阻塞、锁等待等慢操作) | - `pid`:目标进程PID(必填)
- 远程参数(同上)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认30秒)
- `slow_threshold`:慢操作阈值(默认0.5秒) | - 基础状态信息
- `analysis`:卡顿分析字典,包含:
- 慢操作调用详情
- 阻塞类型分类统计
- 耗时最长的系统调用 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | strace_track_file_process | 跟踪进程的文件操作和运行状态(如打开、读取、写入文件等) | - `pid`:目标进程 PID(必填)
- `host`:远程主机 IP/hostname(本地跟踪可不填)
- `port`:SSH 端口(默认 22)
- `username`/`password`:远程跟踪时必填
- `output_file`:日志路径(可选)
- `follow_children`:是否跟踪子进程(默认 False)
- `duration`:跟踪时长(秒,可选) | - `success`:跟踪启动状态
- `message`:结果描述
- `strace_pid`:跟踪进程 ID
- `output_file`:日志路径
- `target_pid`/`host`:目标进程及主机信息 |
+| **strace_mcp** | strace_check_permission_file | 排查进程的"权限不足"和"文件找不到"错误 | - `pid`:目标进程 PID(必填)
- 远程参数(`host`/`port`/`username`/`password`)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认 30 秒) | - 基础状态信息(`success`/`message` 等)
- `errors`:错误统计字典,包含:
- 权限不足错误详情
- 文件找不到错误详情 |
+| | strace_check_network | 诊断进程网络问题(连接失败、超时、DNS 解析等) | - `pid`:目标进程 PID(必填)
- 远程参数(同上)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认 30 秒)
- `trace_dns`:是否跟踪 DNS 调用(默认 True) | - 基础状态信息
- `errors`:网络错误统计,包含:
- 连接被拒绝、超时等错误
- DNS 解析失败详情(若启用) |
+| | strace_locate_freeze | 定位进程卡顿原因(IO 阻塞、锁等待等慢操作) | - `pid`:目标进程 PID(必填)
- 远程参数(同上)
- `output_file`:日志路径(可选)
- `duration`:跟踪时长(默认 30 秒)
- `slow_threshold`:慢操作阈值(默认 0.5 秒) | - 基础状态信息
- `analysis`:卡顿分析字典,包含:
- 慢操作调用详情
- 阻塞类型分类统计
- 耗时最长的系统调用 |
---
#### strace_syscall_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
-| **strace_syscall_mcp** | strace_syscall | 采集指定进程的系统调用统计信息 | - `host`:可选,远程主机地址
- `pid`:目标进程ID(必填)
- `timeout`:采集超时时间,默认10秒 | List\[Dict],每个字典包含:
- `syscall`:系统调用名称
- `total_time`:总耗时(秒)
- `call_count`:调用次数
- `avg_time`:平均耗时(微秒)
- `error_count`:错误次数 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **strace_syscall_mcp** | strace_syscall | 采集指定进程的系统调用统计信息 | - `host`:可选,远程主机地址
- `pid`:目标进程 ID(必填)
- `timeout`:采集超时时间,默认 10 秒 | List\[Dict],每个字典包含:
- `syscall`:系统调用名称
- `total_time`:总耗时(秒)
- `call_count`:调用次数
- `avg_time`:平均耗时(微秒)
- `error_count`:错误次数 |
---
#### swapoff_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------------|--------------------------------------------|------------------------------------------------------------------------------|----------------------------|
-| **swapoff_mcp** | swapoff_disabling_swap_tool | 停用交换空间(Swap),释放已启用的交换分区或交换文件,将其从系统内存管理中移除 | - `host`:远程主机名/IP(本地采集可不填)
- `name`:停用的swap空间路径 | 布尔值,表示停用指定swap空间是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **swapoff_mcp** | swapoff_disabling_swap_tool | 停用交换空间(Swap),释放已启用的交换分区或交换文件,将其从系统内存管理中移除 | - `host`:远程主机名/IP(本地采集可不填)
- `name`:停用的 swap 空间路径 | 布尔值,表示停用指定 swap 空间是否成功 |
---
#### swapon_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **swapon_mcp** | swapon_collect_tool | 获取目标设备(本地/远程)中当前swap设备状态 | - `host`:远程主机名/IP(本地采集可不填) | swap设备列表(含`name`swap空间对应的设备或文件路径、`type`swap空间的类型、`size`swap空间的总大小、`used`当前已使用的swap空间量、`prio`swap空间的优先级) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **swapon_mcp** | swapon_collect_tool | 获取目标设备(本地/远程)中当前 swap 设备状态 | - `host`:远程主机名/IP(本地采集可不填) | swap 设备列表(含 `name` swap 空间对应的设备或文件路径、`type` swap 空间的类型、`size` swap 空间的总大小、`used` 当前已使用的 swap 空间量、`prio` swap 空间的优先级) |
---
#### tail_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **tail_mcp** | tail_file_view_tool | 快速查看文件末尾部分内容 | - `host`:远程主机名/IP(本地采集可不填)
- `num`:查看文件末尾行数,默认为10行
- `file`:查看的文件路径 | 文件内容字符串 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **tail_mcp** | tail_file_view_tool | 快速查看文件末尾部分内容 | - `host`:远程主机名/IP(本地采集可不填)
- `num`:查看文件末尾行数,默认为 10 行
- `file`:查看的文件路径 | 文件内容字符串 |
---
#### tar_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **tar_mcp** | tar_extract_file_tool | 使用tar命令解压文件或目录 | - `host`:远程主机名称或IP地址,若不提供则表示对本机文件进行修改
- `options`:tar命令选项(如`-xzvf`等)
- `file`:压缩包文件路径
- `extract_path`:指定解压目录 | 布尔值,表示解压操作是否成功 |
-| | tar_compress_file_tool | 使用tar命令压缩文件或目录 | - `host`:远程主机名称或IP地址,若不提供则表示对本机文件进行压缩
- `options`:tar命令选项(如`-czvf`、`-xzvf`等)
- `source_path`:需要压缩的文件或目录路径
- `archive_path`:压缩包输出路径 | 布尔值,表示压缩操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **tar_mcp** | tar_extract_file_tool | 使用 tar 命令解压文件或目录 | - `host`:远程主机名称或 IP 地址,若不提供则表示对本机文件进行修改
- `options`:tar 命令选项(如 `-xzvf` 等)
- `file`:压缩包文件路径
- `extract_path`:指定解压目录 | 布尔值,表示解压操作是否成功 |
+| | tar_compress_file_tool | 使用 tar 命令压缩文件或目录 | - `host`:远程主机名称或 IP 地址,若不提供则表示对本机文件进行压缩
- `options`:tar 命令选项(如 `-czvf`、`-xzvf` 等)
- `source_path`:需要压缩的文件或目录路径
- `archive_path`:压缩包输出路径 | 布尔值,表示压缩操作是否成功 |
---
#### touch_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|---------------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **touch_mcp** | touch_create_files_tool | 进行文件快速初始化、批量创建 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:创建的文件名 | 布尔值,表示touch操作是否成功 |
-| | touch_timestamp_files_tool | 进行文件时间戳校准与模拟 | - `host`:远程主机名/IP(本地查询可不填)
- `options`:更新访问时间\更新修改时间(`-a`表示仅更新访问时间、`-m`表示仅更新修改时间)
- `file`:文件名 | 布尔值,表示touch操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **touch_mcp** | touch_create_files_tool | 进行文件快速初始化、批量创建 | - `host`:远程主机名/IP(本地采集可不填)
- `file`:创建的文件名 | 布尔值,表示 touch 操作是否成功 |
+| | touch_timestamp_files_tool | 进行文件时间戳校准与模拟 | - `host`:远程主机名/IP(本地查询可不填)
- `options`:更新访问时间\更新修改时间(`-a` 表示仅更新访问时间、`-m` 表示仅更新修改时间)
- `file`:文件名 | 布尔值,表示 touch 操作是否成功 |
---
#### vmstat_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **vmstat_mcp** | vmstat_collect_tool | 获取目标设备资源整体状态 | - `host`:远程主机名/IP(本地采集可不填) | 系统资源状态字典(含`r`运行队列进程数、`b`等待 I/O 的进程数、`si`每秒从磁盘加载到内存的数据量(KB/s)、`so`每秒从内存换出到磁盘的数据量(KB/s)、`bi`从磁盘读取的块数、`bo`写入磁盘的块数、`in`每秒发生的中断次数(含时钟中断)、`cs`每秒上下文切换次数、`us`用户进程消耗 CPU 时间、`sy`内核进程消耗 CPU 时间、`id`CPU 空闲时间、`wa`CPU 等待 I/O 完成的时间百分比、`st`被虚拟机偷走的 CPU 时间百分比) |
-| | vmstat_slabinfo_collect_tool | 获取内核 slab 内存缓存(slabinfo)的统计信息 | - `host`:远程主机名/IP(本地查询可不填) | slab内存缓存信息详细字典(含`cache`内核中slab缓存名称、`num`当前活跃的缓存对象数量、`total`该缓存的总对象数量、`size`每个缓存对象的大小、`pages`每个slab中包含的缓存对象数量) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **vmstat_mcp** | vmstat_collect_tool | 获取目标设备资源整体状态 | - `host`:远程主机名/IP(本地采集可不填) | 系统资源状态字典(含 `r` 运行队列进程数、`b` 等待 I/O 的进程数、`si` 每秒从磁盘加载到内存的数据量(KB/s)、`so` 每秒从内存换出到磁盘的数据量(KB/s)、`bi` 从磁盘读取的块数、`bo` 写入磁盘的块数、`in` 每秒发生的中断次数(含时钟中断)、`cs` 每秒上下文切换次数、`us` 用户进程消耗 CPU 时间、`sy` 内核进程消耗 CPU 时间、`id` CPU 空闲时间、`wa` CPU 等待 I/O 完成的时间百分比、`st` 被虚拟机偷走的 CPU 时间百分比) |
+| | vmstat_slabinfo_collect_tool | 获取内核 slab 内存缓存(slabinfo)的统计信息 | - `host`:远程主机名/IP(本地查询可不填) | slab 内存缓存信息详细字典(含 `cache` 内核中 slab 缓存名称、`num` 当前活跃的缓存对象数量、`total` 该缓存的总对象数量、`size` 每个缓存对象的大小、`pages` 每个 slab 中包含的缓存对象数量) |
---
#### zip_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **zip_mcp** | zip_extract_file_tool | 使用unzip命令解压zip文件 | - `host`:远程主机名称或IP地址,若不提供则表示对本机文件进行修改
- `file`:压缩包文件路径
- `extract_path`:指定解压目录 | 布尔值,表示解压操作是否成功 |
-| | tar_compress_file_tool | 使用zip命令压缩文件或目录 | - `host`:远程主机名称或IP地址,若不提供则表示对本机文件进行压缩
- `source_path`:需要压缩的文件或目录路径
- `archive_path`:压缩包输出路径 | 布尔值,表示压缩操作是否成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **zip_mcp** | zip_extract_file_tool | 使用 unzip 命令解压 zip 文件 | - `host`:远程主机名称或 IP 地址,若不提供则表示对本机文件进行修改
- `file`:压缩包文件路径
- `extract_path`:指定解压目录 | 布尔值,表示解压操作是否成功 |
+| | tar_compress_file_tool | 使用 zip 命令压缩文件或目录 | - `host`:远程主机名称或 IP 地址,若不提供则表示对本机文件进行压缩
- `source_path`:需要压缩的文件或目录路径
- `archive_path`:压缩包输出路径 | 布尔值,表示压缩操作是否成功 |
---
#### euler-copilot-tune_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-----------------------|--------------------------|------------------------------------------------------------------------------|----------------------------|
-| **tune_mcp** | Collector | 采集机器的性能指标 | | 采集的性能数据 |
-| | Analyzer | 分析采集到的数据 | | 分析报告 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **tune_mcp** | Collector | 采集机器的性能指标 | | 采集的性能数据 |
+| | Analyzer | 分析采集到的数据 | | 分析报告 |
| | Optimizer | 参数+策略 | | 推荐的服务参数 |
| | StartTune | 开始调优 | | 调优完成 |
@@ -990,78 +1014,78 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
#### iftop_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | get_interface_traffic | 通过`iftop`获取指定网卡的实时流量数据(含总流量和Top连接) | - `iface`:网络网卡名称(如eth0,必填)
- `sample_seconds`:采样时长(秒,默认5秒,3-30范围)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认root,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取网卡流量数据")
- `data`:包含流量信息的字典
- `host`:操作的主机名/IP
- `total_stats`:总流量统计(含`interface`网卡名称、`tx_total`/`rx_total`总发送/接收流量(MB)、`tx_rate_avg`/`rx_rate_avg`平均发送/接收速率(Mbps))
- `top_connections`:Top 10连接列表(按接收速率排序) |
-| **iftop_mcp** | list_network_interfaces | 获取本地或远程主机的所有网络网卡名称(用于选择监控目标) | - `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认root,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取3个网卡名称")
- `data`:包含网卡列表的字典
- `host`:操作的主机名/IP
- `interfaces`:网卡名称列表(如["eth0", "lo"]) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | get_interface_traffic | 通过 `iftop` 获取指定网卡的实时流量数据(含总流量和 Top 连接) | - `iface`:网络网卡名称(如 eth0,必填)
- `sample_seconds`:采样时长(秒,默认 5 秒,3-30 范围)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 root,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取网卡流量数据")
- `data`:包含流量信息的字典
- `host`:操作的主机名/IP
- `total_stats`:总流量统计(含 `interface` 网卡名称、`tx_total`/`rx_total` 总发送/接收流量(MB)、`tx_rate_avg`/`rx_rate_avg` 平均发送/接收速率(Mbps))
- `top_connections`:Top 10 连接列表(按接收速率排序) |
+| **iftop_mcp** | list_network_interfaces | 获取本地或远程主机的所有网络网卡名称(用于选择监控目标) | - `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 root,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 3 个网卡名称")
- `data`:包含网卡列表的字典
- `host`:操作的主机名/IP
- `interfaces`:网卡名称列表(如 ["eth0", "lo"]) |
---
#### nload_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | monitor_bandwidth | 通过`nload`获取指定网卡的实时带宽数据(含入站/出站流量详情) | - `iface`:网络网卡名称(如eth0,必填)
- `duration`:监控时长(秒,默认10秒,5-60范围)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取网卡带宽数据")
- `data`:包含带宽信息的字典
- `host`:操作的主机名/IP
- `monitor_duration`:实际监控时长(秒)
- `bandwidth`:带宽监控数据
- `interface`:网卡名称
- `incoming`:入站流量(含current/average/maximum/total/unit字段)
- `outgoing`:出站流量(含current/average/maximum/total/unit字段) |
-| **nload_mcp** | list_network_interfaces | 获取本地或远程主机的所有网络网卡名称(用于选择监控目标) | - `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取3个网卡名称")
- `data`:包含网卡列表的字典
- `host`:操作的主机名/IP
- `interfaces`:网卡名称列表(如["eth0", "lo"]) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | monitor_bandwidth | 通过 `nload` 获取指定网卡的实时带宽数据(含入站/出站流量详情) | - `iface`:网络网卡名称(如 eth0,必填)
- `duration`:监控时长(秒,默认 10 秒,5-60 范围)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取网卡带宽数据")
- `data`:包含带宽信息的字典
- `host`:操作的主机名/IP
- `monitor_duration`:实际监控时长(秒)
- `bandwidth`:带宽监控数据
- `interface`:网卡名称
- `incoming`:入站流量(含 current/average/maximum/total/unit 字段)
- `outgoing`:出站流量(含 current/average/maximum/total/unit 字段) |
+| **nload_mcp** | list_network_interfaces | 获取本地或远程主机的所有网络网卡名称(用于选择监控目标) | - `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 3 个网卡名称")
- `data`:包含网卡列表的字典
- `host`:操作的主机名/IP
- `interfaces`:网卡名称列表(如 ["eth0", "lo"]) |
---
#### netstat_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | query_network_connections | 通过`netstat`查询本地/远程主机的网络连接列表(支持TCP/UDP筛选、TCP状态过滤) | - `proto`:协议类型(tcp/udp/all,默认all)
- `state`:连接状态(仅TCP有效,如ESTABLISHED/LISTENING,默认不筛选)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地TCP连接,共12条")
- `data`:包含连接数据的字典
- `host`:操作的主机名/IP
- `connection_count`:符合条件的连接总数
- `connections`:连接列表(每条含protocol/recv_queue/local_ip/local_port/foreign_ip/foreign_port/state/pid/program字段)
- `filter`:筛选条件(proto/state) |
-| **netstat_mcp** | check_port_occupation | 通过`netstat`检测本地/远程主机指定端口的占用情况(含进程关联信息) | - `port`:端口号(必填,需为1-65535的整数,如80、443)
- `proto`:协议类型(tcp/udp,默认tcp)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `ssh_port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"远程主机192.168.1.100的端口80/TCP被占用:nginx")
- `data`:包含端口占用数据的字典
- `host`:操作的主机名/IP
- `check_port`:检测的端口号
- `proto`:检测的协议
- `is_occupied`:端口是否被占用(布尔值)
- `occupations`:占用列表(每条含protocol/local_ip/pid/program/state字段) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | query_network_connections | 通过 `netstat` 查询本地/远程主机的网络连接列表(支持 TCP/UDP 筛选、TCP 状态过滤) | - `proto`:协议类型(tcp/udp/all,默认 all)
- `state`:连接状态(仅 TCP 有效,如 ESTABLISHED/LISTENING,默认不筛选)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地 TCP 连接,共 12 条")
- `data`:包含连接数据的字典
- `host`:操作的主机名/IP
- `connection_count`:符合条件的连接总数
- `connections`:连接列表(每条含 protocol/recv_queue/local_ip/local_port/foreign_ip/foreign_port/state/pid/program 字段)
- `filter`:筛选条件(proto/state) |
+| **netstat_mcp** | check_port_occupation | 通过 `netstat` 检测本地/远程主机指定端口的占用情况(含进程关联信息) | - `port`:端口号(必填,需为 1-65535 的整数,如 80、443)
- `proto`:协议类型(tcp/udp,默认 tcp)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `ssh_port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "远程主机 192.168.1.100 的端口 80/TCP 被占用:nginx")
- `data`:包含端口占用数据的字典
- `host`:操作的主机名/IP
- `check_port`:检测的端口号
- `proto`:检测的协议
- `is_occupied`:端口是否被占用(布尔值)
- `occupations`:占用列表(每条含 protocol/local_ip/pid/program/state 字段) |
---
#### lsof_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | list_open_files | 查询本地/远程主机的打开文件列表(支持按文件路径、用户筛选) | - `path`:文件路径(可选,指定后仅显示该文件的打开情况)
- `user`:用户名(可选,筛选指定用户打开的文件)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地打开文件,共28个")
- `data`:包含文件信息的字典
- `host`:操作的主机名/IP
- `file_count`:打开的文件总数
- `files`:文件列表(每条含command/pid/user/fd/type/file_path等字段)
- `filter`:筛选条件(path/user) |
-| | list_network_files | 查询本地/远程主机的网络连接相关文件(网络套接字,支持按协议、端口筛选) | - `proto`:协议类型(tcp/udp/all,默认all)
- `port`:端口号(可选,筛选指定端口的网络连接)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `ssh_port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取192.168.1.100的TCP网络连接,共15条")
- `data`:包含网络连接信息的字典
- `host`:操作的主机名/IP
- `connection_count`:网络连接总数
- `connections`:连接列表(每条含command/pid/user/local_address/foreign_address/state等字段)
- `filter`:筛选条件(proto/port) |
-| **lsof_mcp** | find_process_by_file | 查找本地/远程主机中打开指定文件的进程(精准定位文件占用进程) | - `path`:文件路径(必填,如/tmp/test.log、/var/log/nginx/access.log)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"找到2个在本地打开/tmp/test.log的进程")
- `data`:包含进程信息的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `process_count`:相关进程总数
- `processes`:进程列表(每条含command/pid/user/fd等字段) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | list_open_files | 查询本地/远程主机的打开文件列表(支持按文件路径、用户筛选) | - `path`:文件路径(可选,指定后仅显示该文件的打开情况)
- `user`:用户名(可选,筛选指定用户打开的文件)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地打开文件,共 28 个")
- `data`:包含文件信息的字典
- `host`:操作的主机名/IP
- `file_count`:打开的文件总数
- `files`:文件列表(每条含 command/pid/user/fd/type/file_path 等字段)
- `filter`:筛选条件(path/user) |
+| | list_network_files | 查询本地/远程主机的网络连接相关文件(网络套接字,支持按协议、端口筛选) | - `proto`:协议类型(tcp/udp/all,默认 all)
- `port`:端口号(可选,筛选指定端口的网络连接)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `ssh_port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 192.168.1.100 的 TCP 网络连接,共 15 条")
- `data`:包含网络连接信息的字典
- `host`:操作的主机名/IP
- `connection_count`:网络连接总数
- `connections`:连接列表(每条含 command/pid/user/local_address/foreign_address/state 等字段)
- `filter`:筛选条件(proto/port) |
+| **lsof_mcp** | find_process_by_file | 查找本地/远程主机中打开指定文件的进程(精准定位文件占用进程) | - `path`:文件路径(必填,如 /tmp/test.log、/var/log/nginx/access.log)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "找到 2 个在本地打开 /tmp/test.log 的进程")
- `data`:包含进程信息的字典
- `host`:操作的主机名/IP
- `file_path`:目标文件路径
- `process_count`:相关进程总数
- `processes`:进程列表(每条含 command/pid/user/fd 等字段) |
---
#### ifconfig_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | get_network_interfaces | 查询本地/远程主机的网络接口详细信息(支持指定单网卡或返回所有网卡) | - `iface`:网卡名称(可选,如eth0,不填则返回所有网卡)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地所有网卡信息,共3个")
- `data`:包含网卡信息的字典
- `host`:操作的主机名/IP
- `interface_count`:网卡总数
- `interfaces`:网卡列表(每条含name/status/mac_address/ipv4/ipv6/mtu/statistics等字段)
- `filter`:筛选条件(iface) |
-| **ifconfig_mcp** | get_interface_ip | 查询本地/远程主机指定网卡的IP地址信息(专注于IPv4/IPv6地址提取) | - `iface`:网卡名称(必填,如eth0、ens33)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取eth0的IP地址信息")
- `data`:包含IP信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `ipv4`:IPv4地址信息(address/subnet_mask/broadcast)
- `ipv6`:IPv6地址信息(address) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | get_network_interfaces | 查询本地/远程主机的网络接口详细信息(支持指定单网卡或返回所有网卡) | - `iface`:网卡名称(可选,如 eth0,不填则返回所有网卡)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地所有网卡信息,共 3 个")
- `data`:包含网卡信息的字典
- `host`:操作的主机名/IP
- `interface_count`:网卡总数
- `interfaces`:网卡列表(每条含 name/status/mac_address/ipv4/ipv6/mtu/statistics 等字段)
- `filter`:筛选条件(iface) |
+| **ifconfig_mcp** | get_interface_ip | 查询本地/远程主机指定网卡的 IP 地址信息(专注于 IPv4/IPv6 地址提取) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 eth0 的 IP 地址信息")
- `data`:包含 IP 信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `ipv4`:IPv4 地址信息(address/subnet_mask/broadcast)
- `ipv6`:IPv6 地址信息(address) |
---
#### ethtool_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | get_interface_details | 查询指定网卡的基础硬件信息(驱动、固件、速率等) | - `iface`:网卡名称(必填,如eth0、ens33)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地网卡eth0的详细信息")
- `data`:包含网卡信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `basic_info`:基础信息(driver/version/firmware_version/speed/duplex/link_detected等) |
-| | get_interface_features | 查询指定网卡的特性支持情况(网络协议特性、速率模式等) | - `iface`:网卡名称(必填,如eth0、ens33)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地网卡eth0的特性信息")
- `data`:包含特性信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `features`:特性列表(supported/advertised/speed_duplex) |
-| **ethtool_mcp** | set_interface_speed | 设置指定网卡的速率和双工模式(需要管理员权限) | - `iface`:网卡名称(必填,如eth0、ens33)
- `speed`:速率(Mbps,必填,如10/100/1000)
- `duplex`:双工模式(必填,full/half)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功将eth0设置为1000Mbps全双工")
- `data`:包含配置结果的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `configured`:配置信息(speed/duplex) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | get_interface_details | 查询指定网卡的基础硬件信息(驱动、固件、速率等) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地网卡 eth0 的详细信息")
- `data`:包含网卡信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `basic_info`:基础信息(driver/version/firmware_version/speed/duplex/link_detected 等) |
+| | get_interface_features | 查询指定网卡的特性支持情况(网络协议特性、速率模式等) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地网卡 eth0 的特性信息")
- `data`:包含特性信息的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `features`:特性列表(supported/advertised/speed_duplex) |
+| **ethtool_mcp** | set_interface_speed | 设置指定网卡的速率和双工模式(需要管理员权限) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `speed`:速率(Mbps,必填,如 10/100/1000)
- `duplex`:双工模式(必填,full/half)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功将 eth0 设置为 1000Mbps 全双工")
- `data`:包含配置结果的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `configured`:配置信息(speed/duplex) |
---
#### tshark_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | capture_packets | 捕获指定网卡的网络数据包(支持时长、包数、过滤规则限制) | - `iface`:网卡名称(必填,如eth0、ens33)
- `duration`:捕获时长(秒,默认10,范围3-60)
- `count`:最大捕获包数(可选,如100,达到即停止)
- `filter`:抓包过滤规则(可选,如`tcp port 80`,遵循pcap语法)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"在本地网卡eth0上成功捕获58个数据包")
- `data`:包含抓包数据的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `capture_params`:抓包参数(duration/count/filter)
- `packet_count`:实际捕获包数
- `packets`:数据包列表(每条含packet_id/timestamp/src_ip/dst_ip等字段) |
-| **tcpdump_mcp** | analyze_protocol_stats | 分析指定网卡的网络协议分布(统计各协议数据包占比) | - `iface`:网卡名称(必填,如eth0、ens33)
- `duration`:分析时长(秒,默认10,范围3-60)
- `filter`:分析过滤规则(可选,如`ip`,仅统计符合条件的流量)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功分析本地网卡eth0的协议分布,共捕获120个数据包")
- `data`:包含统计数据的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `analysis_params`:分析参数(duration/filter)
- `stats`:协议统计信息(total_packets总包数、protocols各协议计数) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | capture_packets | 捕获指定网卡的网络数据包(支持时长、包数、过滤规则限制) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `duration`:捕获时长(秒,默认 10,范围 3-60)
- `count`:最大捕获包数(可选,如 100,达到即停止)
- `filter`:抓包过滤规则(可选,如 `tcp port 80`,遵循 pcap 语法)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "在本地网卡 eth0 上成功捕获 58 个数据包")
- `data`:包含抓包数据的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `capture_params`:抓包参数(duration/count/filter)
- `packet_count`:实际捕获包数
- `packets`:数据包列表(每条含 packet_id/timestamp/src_ip/dst_ip 等字段) |
+| **tcpdump_mcp** | analyze_protocol_stats | 分析指定网卡的网络协议分布(统计各协议数据包占比) | - `iface`:网卡名称(必填,如 eth0、ens33)
- `duration`:分析时长(秒,默认 10,范围 3-60)
- `filter`:分析过滤规则(可选,如 `ip`,仅统计符合条件的流量)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用,覆盖配置端口) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功分析本地网卡 eth0 的协议分布,共捕获 120 个数据包")
- `data`:包含统计数据的字典
- `host`:操作的主机名/IP
- `interface`:网卡名称
- `analysis_params`:分析参数(duration/filter)
- `stats`:协议统计信息(total_packets 总包数、protocols 各协议计数) |
-#### firewalld_mcp
+---
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | manage_ip_access | 允许/拒绝特定IP/CIDR段访问(基于富规则) | - `ip`:目标IP/CIDR(必填,如192.168.1.100/24)
- `action`:操作类型(必填,allow/deny)
- `zone`:防火墙区域(默认public)
- `protocol`:协议(tcp/udp/all,默认all)
- `permanent`:是否永久生效(默认True)
- `host`:远程主机名/IP(默认localhost)
- `port`:SSH端口(默认22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功允许IP 192.168.1.100访问public区域")
- `data`:包含配置信息的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `rule`:规则详情(ip/action/protocol) |
-| | manage_port_access | 添加/移除特定端口的访问权限 | - `port`:端口/端口范围(必填,如80、80-90)
- `protocol`:协议(tcp/udp,默认tcp)
- `action`:操作类型(必填,add/remove)
- `zone`:防火墙区域(默认public)
- `permanent`:是否永久生效(默认True)
- `host`:远程主机名/IP(默认localhost)
- `ssh_port`:SSH端口(默认22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功添加端口80/tcp访问public区域")
- `data`:包含配置信息的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `rule`:规则详情(port/protocol/action) |
-| | configure_port_forward | 配置端口转发(源端口→目标IP:端口) | - `source_port`:源端口(必填,如80)
- `dest_ip`:目标IP(必填,如192.168.2.100)
- `dest_port`:目标端口(必填,如8080)
- `protocol`:协议(tcp/udp,默认tcp)
- `action`:操作类型(add/remove,默认add)
- `zone`:防火墙区域(默认public)
- `permanent`:是否永久生效(默认True)
- `host`:远程主机名/IP(默认localhost)
- `port`:SSH端口(默认22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功配置端口转发80/tcp→192.168.2.100:8080")
- `data`:包含转发规则的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `forward_rule`:转发详情(source_port/dest_ip等) |
-| | list_firewall_rules | 展示指定区域/所有区域的防火墙规则 | - `zone`:目标区域(可选,不填则查所有)
- `host`:远程主机名/IP(默认localhost)
- `port`:SSH端口(默认22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取所有区域规则,共12条")
- `data`:包含规则信息的字典
- `host`:操作的主机名/IP
- `zone`:查询的区域
- `rule_count`:规则总数
- `rules`:规则列表(按区域分组) |
-| **firewalld_mcp** | list_firewall_zones | 展示所有防火墙区域信息(含默认区域、关联接口) | - `host`:远程主机名/IP(默认localhost)
- `port`:SSH端口(默认22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取5个区域信息,默认区域public")
- `data`:包含区域信息的字典
- `host`:操作的主机名/IP
- `zone_count`:区域总数
- `default_zone`:默认区域
- `zones`:区域列表(含名称、关联接口等) |
+#### firewalld_mcp
-基于 `iptables` 工具封装,提供IP访问控制规则管理、DNAT端口转发配置、规则查询及IP转发功能开关能力,支持本地及远程主机操作,可设置规则保存与持久化状态。
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | manage_ip_access | 允许/拒绝特定 IP/CIDR 段访问(基于富规则) | - `ip`:目标 IP/CIDR(必填,如 192.168.1.100/24)
- `action`:操作类型(必填,allow/deny)
- `zone`:防火墙区域(默认 public)
- `protocol`:协议(tcp/udp/all,默认 all)
- `permanent`:是否永久生效(默认 True)
- `host`:远程主机名/IP(默认 localhost)
- `port`:SSH 端口(默认 22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功允许 IP 192.168.1.100 访问 public 区域")
- `data`:包含配置信息的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `rule`:规则详情(ip/action/protocol) |
+| | manage_port_access | 添加/移除特定端口的访问权限 | - `port`:端口/端口范围(必填,如 80、80-90)
- `protocol`:协议(tcp/udp,默认 tcp)
- `action`:操作类型(必填,add/remove)
- `zone`:防火墙区域(默认 public)
- `permanent`:是否永久生效(默认 True)
- `host`:远程主机名/IP(默认 localhost)
- `ssh_port`:SSH 端口(默认 22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功添加端口 80/tcp 访问 public 区域")
- `data`:包含配置信息的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `rule`:规则详情(port/protocol/action) |
+| | configure_port_forward | 配置端口转发(源端口→目标 IP:端口) | - `source_port`:源端口(必填,如 80)
- `dest_ip`:目标 IP(必填,如 192.168.2.100)
- `dest_port`:目标端口(必填,如 8080)
- `protocol`:协议(tcp/udp,默认 tcp)
- `action`:操作类型(add/remove,默认 add)
- `zone`:防火墙区域(默认 public)
- `permanent`:是否永久生效(默认 True)
- `host`:远程主机名/IP(默认 localhost)
- `port`:SSH 端口(默认 22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功配置端口转发 80/tcp→192.168.2.100:8080")
- `data`:包含转发规则的字典
- `host`:操作的主机名/IP
- `zone`:应用的区域
- `forward_rule`:转发详情(source_port/dest_ip 等) |
+| | list_firewall_rules | 展示指定区域/所有区域的防火墙规则 | - `zone`:目标区域(可选,不填则查所有)
- `host`:远程主机名/IP(默认 localhost)
- `port`:SSH 端口(默认 22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取所有区域规则,共 12 条")
- `data`:包含规则信息的字典
- `host`:操作的主机名/IP
- `zone`:查询的区域
- `rule_count`:规则总数
- `rules`:规则列表(按区域分组) |
+| **firewalld_mcp** | list_firewall_zones | 展示所有防火墙区域信息(含默认区域、关联接口) | - `host`:远程主机名/IP(默认 localhost)
- `port`:SSH 端口(默认 22) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 5 个区域信息,默认区域 public")
- `data`:包含区域信息的字典
- `host`:操作的主机名/IP
- `zone_count`:区域总数
- `default_zone`:默认区域
- `zones`:区域列表(含名称、关联接口等) |
---
@@ -1078,36 +1102,36 @@ OE-容器镜像助手基于 28 个标准化 MCP 工具,构建“Docker 容器
#### npu_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | get_npu_status | 通过`npu-smi`获取NPU设备状态信息(支持查询单个/所有设备) | - `npu_id`:特定NPU设备ID(可选,默认查询所有设备)
- `host`:远程主机名/IP(默认`localhost`,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认`root`,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取2个NPU设备信息")
- `data`:包含NPU状态的字典
- `host`:操作的主机名/IP
- `npus`:NPU设备列表,每个设备包含:
- `Id`:设备ID(整数)
- `Name`:设备名称
- `Memory-Usage`:内存使用(含used/total)
- `Utilization`:设备利用率(%)
- `Temperature`:温度(°C) |
-| | set_npu_power_limit | 通过`npu-smi`设置NPU设备的功率限制(单位:瓦特) | - `npu_id`:NPU设备ID(非负整数,必填)
- `power_limit`:功率限制值(正整数,必填)
- `host`:远程主机名/IP(默认`localhost`,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认`root`,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"功率限制已设置为150瓦特")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `npu_id`:目标设备ID
- `power_limit`:设置的功率值(瓦特) |
-| **npu_mcp** | reset_npu_device | 通过`npu-smi`重置NPU设备(用于故障恢复) | - `npu_id`:NPU设备ID(非负整数,必填)
- `host`:远程主机名/IP(默认`localhost`,本地操作可不填)
- `port`:SSH端口(默认22,远程操作时使用)
- `username`:SSH用户名(默认`root`,远程操作时需指定)
- `password`:SSH密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"NPU设备3已成功重置")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `npu_id`:被重置的设备ID |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | get_npu_status | 通过 `npu-smi` 获取 NPU 设备状态信息(支持查询单个/所有设备) | - `npu_id`:特定 NPU 设备 ID(可选,默认查询所有设备)
- `host`:远程主机名/IP(默认 `localhost`,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 `root`,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 2 个 NPU 设备信息")
- `data`:包含 NPU 状态的字典
- `host`:操作的主机名/IP
- `npus`:NPU 设备列表,每个设备包含:
- `Id`:设备 ID(整数)
- `Name`:设备名称
- `Memory-Usage`:内存使用(含 used/total)
- `Utilization`:设备利用率(%)
- `Temperature`:温度(°C) |
+| | set_npu_power_limit | 通过 `npu-smi` 设置 NPU 设备的功率限制(单位:瓦特) | - `npu_id`:NPU 设备 ID(非负整数,必填)
- `power_limit`:功率限制值(正整数,必填)
- `host`:远程主机名/IP(默认 `localhost`,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 `root`,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "功率限制已设置为 150 瓦特")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `npu_id`:目标设备 ID
- `power_limit`:设置的功率值(瓦特) |
+| **npu_mcp** | reset_npu_device | 通过 `npu-smi` 重置 NPU 设备(用于故障恢复) | - `npu_id`:NPU 设备 ID(非负整数,必填)
- `host`:远程主机名/IP(默认 `localhost`,本地操作可不填)
- `port`:SSH 端口(默认 22,远程操作时使用)
- `username`:SSH 用户名(默认 `root`,远程操作时需指定)
- `password`:SSH 密码(远程操作时必填) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "NPU 设备 3 已成功重置")
- `data`:包含操作详情的字典
- `host`:操作的主机名/IP
- `npu_id`:被重置的设备 ID |
---
#### sync_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **sync_mcp** | sync_refresh_data_tool | 将内存缓冲区数据写入磁盘 | - `host`:远程主机名/IP(本地采集可不填) | 布尔值,表示缓冲数据是否刷新成功 |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **sync_mcp** | sync_refresh_data_tool | 将内存缓冲区数据写入磁盘 | - `host`:远程主机名/IP(本地采集可不填) | 布尔值,表示缓冲数据是否刷新成功 |
---
#### qemu_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| | manage_vm | 本地/远程主机虚拟机全生命周期管理(创建/启动/停止/删除/修改配置) | - `name`:虚拟机名称(必填,唯一标识虚拟机)
- `action`:操作类型(create/start/stop/delete/modify,必填)
- `arch`:CPU架构(create时必填,如x86_64/arm64)
- `memory`:内存大小(create/modify可选,如2G/4096M,默认2G)
- `disk`:磁盘配置(create/modify可选,格式"path=/data/vm/disk.qcow2,size=20G")
- `iso`:系统镜像路径(create可选,如/data/iso/ubuntu-22.04.iso)
- `vcpus`:CPU核心数(create/modify可选,默认2核)
- `vm_dir`:虚拟机存储目录(create可选,默认/var/lib/qemu)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `ssh_port`:SSH端口(默认22,远程操作时使用)
- `ssh_user`:SSH用户名(远程操作必填)
- `ssh_pwd`:SSH密码(远程操作必填,与ssh_key二选一)
- `ssh_key`:SSH私钥路径(远程操作可选,优先于密码) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"虚拟机ubuntu-vm create成功")
- `data`:包含虚拟机操作信息的字典
- `host`:操作的主机名/IP
- `vm_name`:虚拟机名称
- `action`:执行的操作类型
- `details`:操作详情(如修改前后配置对比、磁盘路径) |
-| | list_vms | 本地/远程主机虚拟机列表查询(支持按状态、架构、名称筛选) | - `status`:虚拟机状态(可选,running/stopped/all,默认all)
- `arch`:CPU架构(可选,如x86_64/arm64,筛选指定架构虚拟机)
- `filter_name`:名称模糊筛选(可选,如"ubuntu"筛选含该字段的虚拟机)
- `vm_dir`:虚拟机存储目录(默认/var/lib/qemu)
- `host`/`ssh_port`/`ssh_user`/`ssh_pwd`/`ssh_key`:同`manage_vm` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取本地运行中虚拟机,共3个")
- `data`:包含虚拟机列表的字典
- `host`:操作的主机名/IP
- `vm_count`:虚拟机总数
- `vms`:虚拟机列表,每个设备包含:
- `name`:虚拟机名称
- `arch`:CPU架构
- `vcpus`:CPU核心数
- `memory`:内存大小
- `disk`:磁盘配置(路径+大小)
- `status`:运行状态(running/stopped) |
-| **qemu_mcp** | monitor_vm_status | 本地/远程主机虚拟机实时状态监控(CPU/内存/磁盘/网络) | - `name`:虚拟机名称(必填,指定监控目标)
- `metrics`:监控指标(可选,cpu/memory/disk/network/all,默认all)
- `interval`:监控采样间隔(可选,单位秒,默认5秒,最小值1秒)
- `count`:采样次数(可选,默认1次,0表示持续采样直到手动停止)
- `host`/`ssh_port`/`ssh_user`/`ssh_pwd`/`ssh_key`:同`manage_vm` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功获取ubuntu-vm 5次采样数据")
- `data`:包含监控数据的字典
- `host`:操作的主机名/IP
- `vm_name`:虚拟机名称
- `timestamp`:采样时间列表(对应每条数据的时间戳)
- `metrics_data`:监控指标数据(按metrics字段返回对应指标的采样值) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| | manage_vm | 本地/远程主机虚拟机全生命周期管理(创建/启动/停止/删除/修改配置) | - `name`:虚拟机名称(必填,唯一标识虚拟机)
- `action`:操作类型(create/start/stop/delete/modify,必填)
- `arch`:CPU 架构(create 时必填,如 x86_64/arm64)
- `memory`:内存大小(create/modify 可选,如 2G/4096M,默认 2G)
- `disk`:磁盘配置(create/modify 可选,格式 "path=/data/vm/disk.qcow2,size=20G")
- `iso`:系统镜像路径(create 可选,如 /data/iso/ubuntu-22.04.iso)
- `vcpus`:CPU 核心数(create/modify 可选,默认 2 核)
- `vm_dir`:虚拟机存储目录(create 可选,默认 /var/lib/qemu)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `ssh_port`:SSH 端口(默认 22,远程操作时使用)
- `ssh_user`:SSH 用户名(远程操作必填)
- `ssh_pwd`:SSH 密码(远程操作必填,与 ssh_key 二选一)
- `ssh_key`:SSH 私钥路径(远程操作可选,优先于密码) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "虚拟机 ubuntu-vm create 成功")
- `data`:包含虚拟机操作信息的字典
- `host`:操作的主机名/IP
- `vm_name`:虚拟机名称
- `action`:执行的操作类型
- `details`:操作详情(如修改前后配置对比、磁盘路径) |
+| | list_vms | 本地/远程主机虚拟机列表查询(支持按状态、架构、名称筛选) | - `status`:虚拟机状态(可选,running/stopped/all,默认 all)
- `arch`:CPU 架构(可选,如 x86_64/arm64,筛选指定架构虚拟机)
- `filter_name`:名称模糊筛选(可选,如 "ubuntu" 筛选含该字段的虚拟机)
- `vm_dir`:虚拟机存储目录(默认 /var/lib/qemu)
- `host`/`ssh_port`/`ssh_user`/`ssh_pwd`/`ssh_key`:同 `manage_vm` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取本地运行中虚拟机,共 3 个")
- `data`:包含虚拟机列表的字典
- `host`:操作的主机名/IP
- `vm_count`:虚拟机总数
- `vms`:虚拟机列表,每个设备包含:
- `name`:虚拟机名称
- `arch`:CPU 架构
- `vcpus`:CPU 核心数
- `memory`:内存大小
- `disk`:磁盘配置(路径+大小)
- `status`:运行状态(running/stopped) |
+| **qemu_mcp** | monitor_vm_status | 本地/远程主机虚拟机实时状态监控(CPU/内存/磁盘/网络) | - `name`:虚拟机名称(必填,指定监控目标)
- `metrics`:监控指标(可选,cpu/memory/disk/network/all,默认 all)
- `interval`:监控采样间隔(可选,单位秒,默认 5 秒,最小值 1 秒)
- `count`:采样次数(可选,默认 1 次,0 表示持续采样直到手动停止)
- `host`/`ssh_port`/`ssh_user`/`ssh_pwd`/`ssh_key`:同 `manage_vm` | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功获取 ubuntu-vm 5 次采样数据")
- `data`:包含监控数据的字典
- `host`:操作的主机名/IP
- `vm_name`:虚拟机名称
- `timestamp`:采样时间列表(对应每条数据的时间戳)
- `metrics_data`:监控指标数据(按 metrics 字段返回对应指标的采样值) |
---
#### nmap_mcp
-| MCP_Server名称 | MCP_Tool列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
-|----------------|-------------------------|--------------------------------------------|------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **nmap_mcp** | scan_network | 本地/远程主机的IP/网段扫描(支持主机发现、端口探测、服务识别) | - `target`:扫描目标(必填,支持单个IP、CIDR网段、IP范围,如192.168.1.1、192.168.1.0/24、192.168.1.1-100)
- `scan_type`:扫描类型(可选,basic/full/quick,默认basic;basic=常用100端口,full=1-65535全端口,quick=10个核心端口)
- `port_range`:自定义端口范围(可选,如22,80-443,优先级高于scan_type)
- `host_discovery`:是否仅主机发现(不扫描端口,True/False,默认False)
- `host`:远程主机名/IP(默认localhost,本地操作可不填)
- `ssh_port`:SSH端口(默认22,远程操作时使用)
- `ssh_user`:SSH用户名(远程操作必填)
- `ssh_pwd`:SSH密码(远程操作可选,与ssh_key二选一)
- `ssh_key`:SSH私钥路径(远程操作可选,优先于密码) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如"成功扫描192.168.1.0/24,发现8台活跃主机")
- `data`:包含扫描结果的字典
- `host`:执行扫描的主机名/IP
- `target`:扫描目标
- `scan_type`:扫描类型(含custom,即自定义端口)
- `host_count`:发现的主机总数
- `up_host_count`:活跃主机数量
- `results`:主机列表,每个主机包含:
- `ip`:主机IP
- `status`:状态(up/down/unknown)
- `status_details`:状态详情(如延迟时间)
- `open_ports`:开放端口列表(含端口号、状态、服务名、详情) |
+| MCP_Server 名称 | MCP_Tool 列表 | 工具功能 | 核心输入参数 | 关键返回内容 |
+|-----------------|---------------|----------|--------------|--------------|
+| **nmap_mcp** | scan_network | 本地/远程主机的 IP/网段扫描(支持主机发现、端口探测、服务识别) | - `target`:扫描目标(必填,支持单个 IP、CIDR 网段、IP 范围,如 192.168.1.1、192.168.1.0/24、192.168.1.1-100)
- `scan_type`:扫描类型(可选,basic/full/quick,默认 basic;basic=常用 100 端口,full=1-65535 全端口,quick=10 个核心端口)
- `port_range`:自定义端口范围(可选,如 22,80-443,优先级高于 scan_type)
- `host_discovery`:是否仅主机发现(不扫描端口,True/False,默认 False)
- `host`:远程主机名/IP(默认 localhost,本地操作可不填)
- `ssh_port`:SSH 端口(默认 22,远程操作时使用)
- `ssh_user`:SSH 用户名(远程操作必填)
- `ssh_pwd`:SSH 密码(远程操作可选,与 ssh_key 二选一)
- `ssh_key`:SSH 私钥路径(远程操作可选,优先于密码) | - `success`:操作是否成功(布尔值)
- `message`:操作结果描述(如 "成功扫描 192.168.1.0/24,发现 8 台活跃主机")
- `data`:包含扫描结果的字典
- `host`:执行扫描的主机名/IP
- `target`:扫描目标
- `scan_type`:扫描类型(含 custom,即自定义端口)
- `host_count`:发现的主机总数
- `up_host_count`:活跃主机数量
- `results`:主机列表,每个主机包含:
- `ip`:主机 IP
- `status`:状态(up/down/unknown)
- `status_details`:状态详情(如延迟时间)
- `open_ports`:开放端口列表(含端口号、状态、服务名、详情) |
---
diff --git a/docs/zh/openeuler_intelligence/oe_cli/oe_cli_use_guide.md b/docs/zh/openeuler_intelligence/oe_cli/oe_cli_use_guide.md
index 4ce21e7b2b0346fa7454302214ffa6216052fc1b..c649dcdcd6638da5cbff45eabfc59cc95bb516b9 100644
--- a/docs/zh/openeuler_intelligence/oe_cli/oe_cli_use_guide.md
+++ b/docs/zh/openeuler_intelligence/oe_cli/oe_cli_use_guide.md
@@ -24,25 +24,25 @@ oi
### 1.2 智能体选择
-选择智能体,默认为OE-智能运维助手,按上下键选择,回车确认,ESC取消,高亮表示选中。
+选择智能体,默认为 OE-智能运维助手,按上下键选择,回车确认,ESC 取消,高亮表示选中。

### 1.3 智能体使用
-进行智能体的使用,此处以OE-智能运维助手举例,回车确认,进入对话界面
+进行智能体的使用,此处以OE-智能运维助手举例,回车确认,进入对话界面。

### 1.4 工具执行确认
-在左下角输入栏输入命令或问题,如帮我分析当前机器性能情况,智能体会根据提问自动选择合适的 MCP 工具,并询问是否执行,此处点击确认
+在左下角输入栏输入命令或问题,如帮我分析当前机器性能情况,智能体会根据提问自动选择合适的 MCP 工具,并询问是否执行,此处点击确认。

### 1.5 oe-cli预设
-可以在oi前输入以下命令配置客户端
+可以在 oi 前输入以下命令配置客户端。
#### 配置语言
@@ -89,18 +89,18 @@ oi --logs
### 1.7 设置相关
-修改工具执行确认为自动确认 ,点击设置
+修改工具执行确认为自动确认 ,点击设置。


-点击mcp工具授权,可以切换手动确认或自动确认
+点击 mcp 工具授权,可以切换手动确认或自动确认。

-此处也可以配置oi-runtime地址,默认是本机8002端口
+此处也可以配置 oi-runtime 地址,默认是本机 8002 端口。
-点击后端:openEuler Intelligence 可以切换到大模型配置界面进行配置。
+点击后端:openEuler Intelligence 可以切换到大模型配置界面进行配置。

@@ -112,7 +112,7 @@ oi --logs
- **Tab**: 在命令输入框和输出区域之间切换焦点
- **Esc**: 退出应用程序
-### 补充:操作的细节,包括oi --logs日志等,参考shell的[readme](https://gitee.com/openeuler/euler-copilot-shell/blob/master/README.md)
+### 补充:操作的细节,包括 oi --logs 日志等,参考 shell 的 [readme](https://gitee.com/openeuler/euler-copilot-shell/blob/master/README.md)
## 2. 平台演示
@@ -162,7 +162,7 @@ oi

-### 2.4 使用Xshell
+### 2.4 使用 Xshell
#### 打开 oe-cli
@@ -190,13 +190,15 @@ oi
## 3.进阶功能
-### 3.1 自定义mcp
+### 3.1 自定义 MCP
-准备mcp服务,基于mcp协议开发,支持sse格式调用
+准备 MCP 服务,基于 MCP 协议开发,支持 SSE 格式调用。
-首先准备一个json文件,格式如下,需要配置**url**为自定义mcp的访问端口,/sse为标准路由,修改**name、overview、description**,其他内容为默认即可。如下json为openEuler Intelligence对应的mcp服务配置文件:
+首先准备一个 JSON 文件,格式如下,需要配置 **url** 为自定义 MCP 的访问端口,/sse 为标准路由,修改 **name**、**overview**、**description**,其他内容为默认即可。如下 JSON 为 openEuler Intelligence 对应的 MCP 服务配置文件:
-**说明**:init 多次调用会删除之前注册的mcp 服务,重新注册
+> [!NOTE]说明
+>
+> init 多次调用会删除之前注册的 mcp 服务,重新注册。
~~~json
{
@@ -217,27 +219,27 @@ oi
}
~~~
-准备好json文件之后,**命令行执行**下面的命令,注意json文件传入**全路径**,如/tmp/config.json
+准备好 JSON 文件之后,**命令行执行**下面的命令,注意 JSON 文件传入**全路径**,如 /tmp/config.json。
~~~bash
oi-manager --a init /tmp/config.json
~~~
-### 3.2 创建agent
+### 3.2 创建 Agent
-mcp创建完毕之后,**命令行执行**如下命令,此处json文件是步骤3.2创建的,执行完init命令之后json文件中会自动添加serviceId字段用来标识在openEuler Intelligence中创建的mcp服务,create创建的是单个mcp服务对应一个agent智能体。
+MCP 创建完毕之后,**命令行执行**如下命令,此处 JSON 文件是步骤 3.1 创建的,执行完 init 命令之后 JSON 文件中会自动添加 serviceId 字段用来标识在 openEuler Intelligence 中创建的 MCP 服务,create 创建的是单个 MCP 服务对应一个 Agent 智能体。
~~~bash
oi-manager --a create /tmp/config.json
~~~
-config.json 同上,是调用init之后,会在原始json里面添加serviceId字段标识mcp服务
+config.json 同上,是调用 init 之后,会在原始 JSON 里面添加 serviceId 字段标识 MCP 服务。
~~~json
{
"name": "systrace_mcp_server",
- "overview": "systrace 运维 mcp 服务",
- "description": "systrace 运维 mcp 服务",
+ "overview": "systrace 运维 MCP 服务",
+ "description": "systrace 运维 MCP 服务",
"mcpType": "sse",
"author": "root",
"config": {
@@ -249,75 +251,76 @@ config.json 同上,是调用init之后,会在原始json里面添加serviceId
"timeout": 60,
"url": "http://127.0.0.1:12145/sse"
},
- "serviceId":"p2qQke"
+ "serviceId": "p2qQke"
}
~~~
-### 3.3 创建多对一的agent应用
+### 3.3 创建多对一的 Agent 应用
-如果需要创建多个mcp对应一个agent智能体应用,可以在命令行执行如下命令:
+如果需要创建多个 MCP 对应一个 Agent 智能体应用,可以在命令行执行如下命令:
~~~sh
oi-manager --a comb /tmp/comb_config.json
~~~
-需要注意此处的json文件不是步骤3.2创建的,需要重新创建一个json文件,具体内容如下:
+需要注意此处的 JSON 文件不是步骤 3.2 创建的,需要重新创建一个 JSON 文件,具体内容如下:
~~~json
{
- "appType": "agent", #应用类型,不需要修改
- "icon": "", #图标
- "name": "agent_comb", #创建应用的名字
- "description": "测试agent comb", #创建的应用的描述
- "dialogRounds": 3, #对话轮次,默认3
- "permission": { #权限,不需要修改
+ "appType": "agent",
+ "icon": "",
+ "name": "agent_comb",
+ "description": "测试 agent comb",
+ "dialogRounds": 3,
+ "permission": {
"visibility": "public",
"authorizedUsers": []
},
- "workflows": [], #工作流预留参数,不需要修改
+ "workflows": [],
"mcpService": [
{
- "id": "jFOWgw" #注册的mcp返回的serviceId
+ "id": "jFOWgw"
},
{
- "id": "4tA5TO" #注册的mcp返回的serviceId
+ "id": "4tA5TO"
}
],
- "published": "True" #是否公开
+ "published": "True"
}
-
~~~
-说明:此处主要修改name、description、mcpService,mcpService列表里面的id是步骤3.2执行完成后在json文件中自动生成的,需要将多少个mcp配置成一个agent智能体,就配置多少个id。
+> [!NOTE] 说明
+>
+> 此处主要修改 name、description、mcpService,mcpService 列表里面的 id 是步骤 3.2 执行完成后在 JSON 文件中自动生成的,需要将多少个 MCP 配置成一个 Agent 智能体,就配置多少个 id。
-**执行结果日志**
+**执行结果日志**
~~~sh
[root@localhost deploy]# oi-manager --a init /root/mcp_config/perf_mcp/config.json
2025-08-15 09:49:54,874 - mcp_manager - INFO - 成功加载配置文件: /root/mcp_config/perf_mcp/config.json
-2025-08-15 09:49:54,874 - mcp_manager - INFO - 删除MCP服务: dJsLV4
-2025-08-15 09:49:54,960 - mcp_manager - INFO - 已删除旧的MCP服务ID
-2025-08-15 09:49:54,961 - mcp_manager - INFO - 创建MCP服务
-2025-08-15 09:49:55,060 - mcp_manager - INFO - MCP服务创建成功,service_id: XMZ7Pb
+2025-08-15 09:49:54,874 - mcp_manager - INFO - 删除 MCP 服务: dJsLV4
+2025-08-15 09:49:54,960 - mcp_manager - INFO - 已删除旧的 MCP 服务 ID
+2025-08-15 09:49:54,961 - mcp_manager - INFO - 创建 MCP 服务
+2025-08-15 09:49:55,060 - mcp_manager - INFO - MCP 服务创建成功,service_id: XMZ7Pb
2025-08-15 09:49:55,061 - mcp_manager - INFO - 配置文件已更新: /root/mcp_config/perf_mcp/config.json
2025-08-15 09:49:55,061 - mcp_manager - INFO - 操作执行成功
[root@localhost deploy]# oi-manager --a create /root/mcp_config/perf_mcp/config.json
2025-08-15 09:50:03,819 - mcp_manager - INFO - 成功加载配置文件: /root/mcp_config/perf_mcp/config.json
-2025-08-15 09:50:03,819 - mcp_manager - INFO - 安装MCP服务: XMZ7Pb
-2025-08-15 09:50:04,052 - mcp_manager - INFO - 等待MCP服务就绪: XMZ7Pb
-2025-08-15 09:50:14,955 - mcp_manager - INFO - MCP服务 XMZ7Pb 已就绪 (耗时 9 秒)
-2025-08-15 09:50:14,956 - mcp_manager - INFO - 激活MCP服务: XMZ7Pb
+2025-08-15 09:50:03,819 - mcp_manager - INFO - 安装 MCP 服务: XMZ7Pb
+2025-08-15 09:50:04,052 - mcp_manager - INFO - 等待 MCP 服务就绪: XMZ7Pb
+2025-08-15 09:50:14,955 - mcp_manager - INFO - MCP 服务 XMZ7Pb 已就绪 (耗时 9 秒)
+2025-08-15 09:50:14,956 - mcp_manager - INFO - 激活 MCP 服务: XMZ7Pb
2025-08-15 09:50:15,057 - mcp_manager - INFO - 应用创建成功,app_id: cd4a8f3b-9b25-4608-8d4c-d2c435e15ffd
2025-08-15 09:50:15,057 - mcp_manager - INFO - 发布应用: cd4a8f3b-9b25-4608-8d4c-d2c435e15ffd
-2025-08-15 09:50:15,149 - mcp_manager - INFO - Agent创建流程完成
+2025-08-15 09:50:15,149 - mcp_manager - INFO - Agent 创建流程完成
2025-08-15 09:50:15,149 - mcp_manager - INFO - 操作执行成功
~~~
## 4. 使用案例 euler-copilot-tune 调优的使用
-euler-copilot-tune项目([README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md))适配了mcp协议,支持oi调用。
+euler-copilot-tune 项目([README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md))适配了 MCP 协议,支持 OI 调用。
-采用oi --init方式轻量安装openEuler-Intelligence时,euler-copilot-tune会作为默认的mcp服务安装到服务器上,mcp服务以systemctl管理,服务名称为:tune-mcp_server。如果需要使用**最新版本的euler-copilot-tune**,可以源码下载安装,命令如下:
+采用 oi --init 方式轻量安装 openEuler Intelligence 时,euler-copilot-tune 会作为默认的 MCP 服务安装到服务器上,MCP 服务以 systemctl 管理,服务名称为:tune-mcp_server。如果需要使用**最新版本的 euler-copilot-tune**,可以源码下载安装,命令如下:
~~~bash
git clone https://gitee.com/openeuler/A-Tune.git -b euler-copilot-tune
@@ -330,40 +333,40 @@ python3 setup.py install


-euler-copilot-tune mcp服务归属于OE-通算调优助手。调优主要分为**采集服务数据,分析性能瓶颈,推荐优化参数,开始调优**四个步骤,自然语言交互时围绕这四个步骤按顺序依次提问执行。
+euler-copilot-tune MCP 服务归属于 OE-通算调优助手。调优主要分为**采集服务数据,分析性能瓶颈,推荐优化参数,开始调优**四个步骤,自然语言交互时围绕这四个步骤按顺序依次提问执行。
### 使用前准备
-需要一台被调优机器及服务(如Nginx、Mysql等),可以参考euler-copilot-tune的使用案例准备环境:[README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md#应用示例)
+需要一台被调优机器及服务(如 Nginx、MySQL 等),可以参考 euler-copilot-tune 的使用案例准备环境:[README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md#应用示例)。
-修改/etc/euler-copilot-tune/config/目录下的配置文件**.env.yaml**和**app_config.yaml**,修改内容参考:[README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md#配置文件准备),修改完成后重启 (**systemctl restart tune-mcp_server**) 服务
+修改 /etc/euler-copilot-tune/config/ 目录下的配置文件 **.env.yaml** 和 **app_config.yaml**,修改内容参考:[README](https://gitee.com/openeuler/A-Tune/blob/euler-copilot-tune/README.md#配置文件准备),修改完成后重启(**systemctl restart tune-mcp_server**)服务。

-修改oi-runtime mcp读取默认时间
+修改 oi-runtime MCP 读取默认时间。
~~~sh
vi /etc/euler-copilot-framework/config.toml
-#添加如下配置 单位秒
+# 添加如下配置 单位秒
[mcp_config]
sse_client_read_timeout = 360000
-#重启oi-runtime
+# 重启 oi-runtime
systemctl restart oi-runtime
~~~
### 使用
-**选择OE-通算调优助手**
+**选择 OE-通算调优助手**

-终端输入:帮我采集192.168.159.129 机器的 nginx 服务的性能数据,分析推荐参数,开始调优
+终端输入:帮我采集 192.168.159.129 机器的 nginx 服务的性能数据,分析推荐参数,开始调优。

-点击确认后"tune-mcp_server"会进行数据采集,可以通过如下命令来查看运行日志
+点击确认后 "tune-mcp_server" 会进行数据采集,可以通过如下命令来查看运行日志。
```sh
journalctl -xe -u tune-mcpserver --all -f
@@ -371,7 +374,7 @@ journalctl -xe -u tune-mcpserver --all -f

-执行完Collector后,会依次执行数据分析工具,参数推荐工具,性能调优开始工具
+执行完 Collector后,会依次执行数据分析工具,参数推荐工具,性能调优开始工具。

@@ -379,7 +382,7 @@ journalctl -xe -u tune-mcpserver --all -f

-执行完成之后使用如下命令查看调优运行结果
+执行完成之后使用如下命令查看调优运行结果。
```sh
journalctl -xe -u tune-mcpserver --all -f