MCP Homelab Server 🏠

Model Context Protocol server for homelab management Give AI agents access to your homelab: Docker, Ollama, system stats, and more.

What Is This?

An MCP (Model Context Protocol) server that exposes homelab tools to AI agents like Claude, GPT, or any MCP-compatible client. Instead of writing scripts yourself, just ask your AI agent to manage your infrastructure.

Example conversations:

• "List all running Docker containers"

• "How much RAM is Ollama using?"

• "Pull the llama3 model"

• "Show me disk usage on the server"

Related MCP server: System Monitor MCP Server

Tools Provided

Docker Management

Ollama / LLM Management

System Monitoring

Quick Start

With Claude Desktop / Cursor / any MCP client

Add to your MCP client configuration:

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

With OpenClaw

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

Standalone (for testing)

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

Requirements

• Python 3.10+

• Docker (for Docker tools)

• Ollama (for LLM tools, optional)

• Linux/macOS (system stats rely on standard Unix tools)

Architecture

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

License

MIT