linux-profiler-mcp

charlesyue/linux-profiler-mcp

1 Stars 32 次浏览 charles_yue 更新于 2026-08-23

一个支持通过MCP（模型上下文协议）远程调用的Linux性能分析工具。它提供了CPU、内存、磁盘、网络和进程分析，以及健康检查。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "linux-profiler": {
      "args": [
        "-m",
        "linux_profiler.server"
      ],
      "command": "python",
      "cwd": "/path/to/linux-profiler-tool",
      "env": {
        "PYTHONPATH": "/path/to/linux-profiler-tool/src"
      }
    }
  }
}

该服务需要配置环境变量：PYTHONPATH

SSE 传输配置

{
  "mcpServers": {
    "linux-profiler": {
      "url": "http://your-server:22222/sse"
    }
  }
}

Streamable HTTP 传输配置

{
  "mcpServers": {
    "linux-profiler": {
      "transportType": "streamable-http",
      "url": "http://your-server:22222/mcp"
    }
  }
}

服务介绍

Linux性能分析工具

一个支持 MCP (Model Context Protocol) 协议远程调用的 Linux 性能分析工具。

中文 | English

开源许可

本项目采用 Apache License 2.0 开源许可证。

功能特性

CPU 分析: 使用率、频率、负载均衡、各核心状态
内存分析: 虚拟内存、交换分区、缓存使用
磁盘分析: 分区使用率、I/O 读写统计
网络分析: 接口流量、连接状态、错误统计
进程分析: Top N CPU/内存消耗进程、进程状态统计
健康检查: 自动识别性能问题和告警

项目结构

linux-profiler-tool/
├── src/linux_profiler/
│   ├── __init__.py
│   ├── server.py              # MCP 服务器主入口
│   └── collectors/
│       ├── __init__.py
│       ├── base.py            # 采集器基类
│       ├── cpu.py             # CPU 指标采集
│       ├── memory.py          # 内存指标采集
│       ├── disk.py            # 磁盘 I/O 采集
│       ├── network.py         # 网络指标采集
│       └── process.py         # 进程指标采集
├── pyproject.toml
├── mcp_config.json            # MCP 配置示例
└── README.md

安装

# 克隆项目
cd linux-profiler-tool

# 创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或 .venv\Scripts\activate  # Windows

# 安装依赖（开发模式）
pip install -e .

# 或使用 uv（更快）
uv pip install -e .

# 验证安装
linux-profiler --help

注意: 如果遇到 ModuleNotFoundError: No module named 'linux_profiler' 错误，请参考 FIX_GUIDE.md 进行修复。

使用方式

1. STDIO 模式（本地调用）

# 直接运行（默认 STDIO 模式）
python -m linux_profiler.server

# 或使用安装后的命令
linux-profiler

2. HTTP 模式（远程调用）

支持两种 HTTP 传输协议：

Streamable HTTP（推荐，MCP 新标准）：

# 启动 Streamable HTTP 服务（默认）
linux-profiler --http

# 无状态模式
linux-profiler --http --stateless

# 自定义端口
linux-profiler --http --port 22222

SSE 传输（传统模式）：

# 使用 SSE 传输
linux-profiler --http --transport sse

同时支持两种传输：

# 同时启用 SSE 和 Streamable HTTP
linux-profiler --http --transport both

启动后可访问的端点：

传输类型	端点	说明
Streamable HTTP	`/mcp`	MCP 主端点（GET/POST/DELETE）
SSE	`/sse`	SSE 连接端点
SSE	`/sse/messages/`	SSE 消息端点（仅 both 模式）
通用	`/health`	健康检查
通用	`/`	服务信息

3. 配置 MCP 客户端

STDIO 模式配置：

{
  "mcpServers": {
    "linux-profiler": {
      "command": "python",
      "args": ["-m", "linux_profiler.server"],
      "cwd": "/path/to/linux-profiler-tool",
      "env": {
        "PYTHONPATH": "/path/to/linux-profiler-tool/src"
      }
    }
  }
}

Streamable HTTP 模式配置（推荐）：

{
  "mcpServers": {
    "linux-profiler": {
      "url": "http://your-server:22222/mcp",
      "transportType": "streamable-http"
    }
  }
}

SSE 模式配置（传统）：

{
  "mcpServers": {
    "linux-profiler": {
      "url": "http://your-server:22222/sse"
    }
  }
}

可用的 MCP Tools

工具名称	描述
`get_system_info`	获取系统基本信息（主机名、OS、内核版本等）
`get_cpu_metrics`	获取 CPU 使用率、频率、负载均衡
`get_memory_metrics`	获取内存和交换分区使用情况
`get_disk_metrics`	获取磁盘分区和 I/O 统计
`get_network_metrics`	获取网络接口流量和连接状态
`get_process_metrics`	获取进程统计和 Top N 资源消耗者
`get_all_metrics`	获取所有性能指标的综合报告
`get_performance_summary`	获取性能摘要和问题告警

示例输出

get_performance_summary

{
  "status": "warning",
  "timestamp": "2026-01-14T10:30:00",
  "summary": {
    "cpu_percent": 45.2,
    "load_average_1min": 2.5,
    "memory_percent": 72.3,
    "swap_percent": 15.0
  },
  "issues": [],
  "warnings": [
    "Warning: Memory usage is high (72.3%)"
  ]
}

命令行参数

参数	说明
`--http`	启用 HTTP 模式（默认为 STDIO 模式）
`--port, -p`	HTTP 监听端口（默认: 22222）
`--host, -H`	HTTP 监听地址（默认: 0.0.0.0）
`--transport, -t`	传输类型: `streamable`（默认）、`sse`、`both`
`--stateless`	Streamable HTTP 无状态模式

环境变量

变量	说明	默认值
`PROFILER_PORT`	HTTP 默认端口	22222
`PROFILER_HOST`	HTTP 默认地址	0.0.0.0
`PROFILER_TRANSPORT`	默认传输类型	streamable

依赖

Python >= 3.10
mcp >= 1.0.0
psutil >= 5.9.0
starlette >= 0.27.0
uvicorn >= 0.24.0
pydantic >= 2.0.0

License

Copyright 2026 Linux Profiler MCP Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

See LICENSE for the full license text.

查看源码项目主页