内容
# 系统诊断 MCP 服务器
提供Ubuntu系统的全面系统诊断和监控功能。
## 功能
### 🧠 核心诊断
- **检查端口** – 测试TCP端口是否打开
- **ping主机** – 对远程主机进行ICMP ping
- **DNS查询** – 解析域名DNS记录
- **HTTP检查** – 检查URL的HTTP状态
- **跟踪主机** – 跟踪到主机的网络路径
- **获取运行时间** – 返回系统运行时间
- **获取系统信息** – 基本系统信息（CPU、内存、磁盘）
- **获取主机名** – 获取机器主机名
### ⚙️ 服务和进程监控
- **列出进程** – 列出正在运行的进程（类似 ps）
- **列出服务** – 列出systemd或init服务
- **服务状态** – 特定服务的狀態
- **读取日志** – 获取某个单元或标签的最新日志
- **列出定时任务** – 显示当前用户的定时任务
### 📦 磁盘和内存
- **检查磁盘使用情况** – 磁盘使用情况总结（类似 df）
- **检查内存** – RAM/交换内存使用情况（类似 free）
- **检查inode使用情况** – 文件系统inode统计信息
- **列出挂载点** – 已挂载的卷
### 🔌 网络和端口
- **列出开放端口** – 显示开放的TCP/UDP端口
- **检查防火墙状态** – UFW/iptables总结
- **列出网络接口** – IP、MAC、链路状态
- **检查带宽使用情况** – 网络流量统计信息
- **解析主机** – IP地址的反向DNS
- **curl URL** – 使用curl发送GET请求，包含完整头部信息
### 🔒 安全和访问
- **列出用户** – 本地用户
- **最近登录尝试** – 最近的登录尝试
- **检查sudo权限** – 哪些用户可以sudo
- **当前登录用户** – 当前会话
## 安装
### 使用uv（推荐）
```bash
# 如果尚未安装uv，请安装
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装软件包
uv pip install system-diag-mcp
```
### 使用pip
```bash
pip install system-diag-mcp
```
## 使用
### 作为独立服务器
```bash
system-diag-mcp
```
### 与Claude Desktop一起使用
将以下内容添加到Claude Desktop配置中：
```json
{
"mcpServers": {
"system-diag": {
"command": "system-diag-mcp"
}
}
}
```
### 与其他MCP客户端一起使用
服务器在标准输入/输出上运行，并实现了完整的MCP协议。
## 开发
```bash
# 克隆仓库
git clone <仓库URL>
cd system-diag-mcp
# 安装开发依赖项
uv pip install -e ".[dev]"
# 运行测试
pytest
# 格式化代码
black .
ruff check .
```
## 要求
- Python 3.8+
- 基于Ubuntu/Debian的系统
- 需要的系统工具：`ping`、`dig`、`traceroute`、`systemctl`、`ps`、`df`、`free`、`curl`
## 许可证
MIT 许可证
