基础设施 MCP 服务器

使用模型上下文协议（MCP）为 Claude Desktop 提供基于人工智能的基础设施监控。

实时监控您的系统，包括 CPU、内存、日志、网络以及智能的人工智能分析。

🚀 快速开始

# 1. 安装依赖项
pip install -r requirements.txt

# 2. 测试服务器
python test_client.py

# 3. 配置 Claude Desktop
# 编辑：~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "infra-monitor": {
      "command": "python3",
      "args": ["-m", "infra_mcp.server"],
      "cwd": "/path/to/InfraGPT-MCP"
    }
  }
}

# 4. 重启 Claude Desktop 并询问：
# "检查系统健康状况"

📖 完整设置指南 →

✨ 功能

功能	描述
🖥️ 系统监控	实时监控 CPU、内存、磁盘和进程
📊 日志分析	基于人工智能的系统日志分析（syslog、auth、内核）
🌐 网络监控	网络接口、连接和 I/O 统计
👥 用户管理	活动会话和身份验证监控
🤖 AI 洞察	使用 Google Gemini 的智能分析（可选）
🏥 健康检查	自动系统健康评分和建议
🔒 模拟模式	不依赖外部 API 的完整功能

🛠️ 可用工具

通过 Claude Desktop 访问的 7 个强大工具：

• get_system_info - 获取 CPU、内存、磁盘指标
• get_service_status - 进程和服务监控
• get_user_info - 用户会话和活动
• get_logs - 系统日志检索
• get_network_info - 网络接口和连接
• analyze_logs - 基于人工智能的日志分析
• health_check - 全面的系统健康评估

💡 使用示例

系统健康检查：

您：检查整体系统健康状况
Claude：✅ 系统健康评分：8/10
        CPU: 15%，内存: 46%，磁盘: 10%...

日志分析：

您：分析最近的日志以查找安全问题
Claude：🔒 安全分析：未检测到威胁
        发现了 3 个身份验证事件...

服务监控：

您：哪些服务占用最多的 CPU？
Claude：顶级进程：WindowServer (3.2%)，Docker (1.8%)...

📚 文档

• 快速开始指南 - 五分钟内启动并运行
• 设置与配置 - 详细的 Claude Desktop 设置
• 架构 - 技术架构和设计
• 架构图 - 视觉系统图（Mermaid）

🔧 要求

• 操作系统: macOS 11+ 或 Linux
• Python: 3.8 或更高版本
• Claude Desktop: 最新版本
• 可选: Google Gemini API 密钥用于真实的人工智能分析

🎯 架构

Claude Desktop (MCP 客户端)
        ↓ JSON-RPC 通过标准 I/O
基础设施 MCP 服务器
        ↓ 使用
系统资源 (psutil)
        ↓ 可选
Google Gemini API

查看详细架构图 →

🔐 安全与隐私

• ✅ 作为用户进程运行（无需 root 权限）
• ✅ 首先进行本地处理
• ✅ 不存储数据（临时分析）
• ✅ 可选外部 API（Gemini）
• ✅ 优雅的权限处理

🧪 测试

# 运行全面测试
python test_client.py

# 预期输出：
# ✅ 7 个工具可用
# ✅ 所有测试通过

🐛 故障排除

服务器无法加载？

• 检查 Claude Desktop 配置语法
• 验证 Python 是否可访问
• 查看日志：tail -f ~/Library/Logs/Claude/mcp.log

权限错误？

• 正常 - 服务器优雅处理
• 部分日志需要提升权限

需要帮助？ 查看 故障排除指南

🤝 贡献

欢迎贡献！该项目遵循标准开源实践。

📄 许可证

MIT 许可证 - 详情见 LICENSE 文件。

🌟 项目状态

版本: 1.0.0
状态: ✅ 生产就绪
MCP 协议: 2025-06-18
最后更新: 2025年11月21日

---

准备开始了吗？ → 快速开始指南

有问题吗？ → 文档