Linux系统诊断工具

一个轻量级CLI客户端,用于通过Linux MCP服务器进行交互式系统诊断和故障排除。

  • by alexjch
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 alexjch/linux-mcp-agent

使用说明

mcp-linux代理

一个轻量级的CLI客户端 Linux MCP服务器此工具在无头服务器上运行,不需要X11或其他显示库,可以直接从终端进行交互式Linux系统诊断。

特性

  • 🤖 交互式聊天界面,支持人工智能故障排除
  • 🔍 通过以下方式进行只读系统诊断 Linux MCP服务器
  • 🎨 具有颜色编码输出的丰富控制台UI
  • ⚙️ 基于环境的配置
  • 🐳 开发容器支持,便于设置

先决条件

安装

开发容器快速入门

  1. 在VS Code中打开项目
  2. 出现提示时重新打开容器
  3. 等待自动设置完成

手动安装

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt
pip install linux-mcp-server

配置

通过环境变量进行配置:

变量 默认值 描述
LINUX_MCP_SERVER .venv/bin/linux-mcp-server MCP服务器可执行文件的路径
LLM_PROVIDER ollama LLM后端(ollama 或 googlegenai)
LLM_MODEL llama3.2:latest 所选后端的型号名称
LLM_BASE_URL http://localhost:11434 Ollama服务器URL(用于 LLM_PROVIDER=ollama)
REQUEST_TIMEOUT 90 请求超时(秒)

提供商示例

启动代理之前,请使用以下配置之一。

Ollama(当地)

export LLM_PROVIDER=ollama
export LLM_MODEL=llama3.2:latest
export LLM_BASE_URL=http://localhost:11434

谷歌GenAI

export LLM_PROVIDER=googlegenai
export LLM_MODEL=gemini-2.0-flash
export GOOGLE_API_KEY=your_api_key_here

用法

# As a module
python -m linux_mcp_agent

# Or directly
python linux_mcp_agent

示例会话

You: What is the free disk space?
Agent: [Analyzes system and provides disk usage information]

You: Check if nginx is running
Agent: [Queries service status and reports findings]

You: exit
Goodbye!

发展

制定目标

make install   # Install dependencies
make format    # Format code with black
make lint      # Run flake8 and mypy
make test      # Run pytest
make all       # Run format, lint, and test
make clean     # Remove cache files

项目结构

linux_mcp_agent/
├── __init__.py      # Package initialization
├── __main__.py      # Entry point
├── agent.py         # Main agent logic
└── config.py        # Configuration management
tests/
├── __init__.py
└── test_config.py   # Configuration tests

建筑

代理人使用:

  • 骆驼索引:LLM驱动的应用程序框架
  • MCP(模型上下文协议):工具访问的标准协议
  • 奥拉玛:本地LLM推理
  • 富有的:终端UI格式

代理以只读模式运行,防止系统修改。

许可证

看 许可证 文件以获取详细信息。