家庭实验室AI代理管理服务器

MCP Homelab Server是一个为AI代理提供家庭实验室管理功能的协议服务器,支持Docker、Ollama和系统监控等工具。

  • by Proto-labs-rnd
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Proto-labs-rnd/mcp-homelab-server

使用说明

MCP家庭实验室服务器🏠

用于家庭实验室管理的模型上下文协议服务器 让AI代理访问您的家庭实验室:Docker、Ollama、系统统计数据等。

这是什么?

一 MCP(模型上下文协议) 将家庭实验室工具暴露给人工智能代理(如Claude、GPT或任何兼容MCP的客户端)的服务器。与其自己编写脚本,不如让你的AI代理来管理你的基础设施。

对话示例:

  • “列出所有正在运行的Docker容器”
  • “Ollama使用了多少RAM?”
  • “拉骆驼3模型”
  • “显示服务器上的磁盘使用情况”

提供的工具

Docker管理

工具 说明
docker_ps 列出正在运行的容器
docker_logs 获取容器日志
docker_restart 重新启动容器
docker_stop 停止容器
docker_stats 资源使用(CPU、RAM、网络)

Ollama/LLM管理

工具 说明
ollama_list 列出已安装的型号
ollama_pull 拉一个新模型
ollama_ps 显示运行模型和内存使用情况
ollama_generate 运行快速推理测试

系统监控

工具 说明
system_stats CPU、RAM、磁盘、正常运行时间
disk_usage 按装载量列出的详细磁盘使用情况
network_status 网络接口和连接
process_top 按CPU/RAM划分的顶级进程

快速开始

使用克劳德桌面/光标/任何MCP客户端

添加到MCP客户端配置中:

{
  "mcpServers": {
    "homelab": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-homelab"]
    }
  }
}

使用OpenClaw

{
  "mcpServers": {
    "homelab": {
      "command": "python3",
      "args": ["path/to/mcp-homelab-server/src/server.py"]
    }
  }
}

独立式(用于测试)

git clone https://github.com/Proto-labs-rnd/mcp-homelab-server.git
cd mcp-homelab-server
pip install -r requirements.txt
python3 src/server.py

需求

  • Python 3.10+
  • Docker(用于Docker工具)
  • Ollama(用于LLM工具,可选)
  • Linux/macOS(系统统计数据依赖于标准Unix工具)

建筑

MCP Client (Claude, Cursor, OpenClaw, etc.)
        │
        ▼
┌─────────────────────┐
│  MCP Server (stdio)  │
│  ┌───────────────┐  │
│  │ Docker Tools  │  │
│  │ Ollama Tools  │  │
│  │ System Tools  │  │
│  └───────────────┘  │
└─────────────────────┘
        │
        ▼
   Your Homelab

许可证

麻省理工学院