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许可证
麻省理工学院