AI导哈

个人实验室MCP服务器

基于FastMCP构建的个人实验室MCP服务器，部署在GCP Cloud Run上，用于管理Proxmox VE的虚拟机、容器、存储、快照和备份等工具。

  • by chrisgermon
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chrisgermon/homelab-mcp-server

使用说明

Homelab MCP服务器

基于FastMCP构建的个人家庭实验室MCP服务器，部署到GCP Cloud Run。

将个人/家庭实验室工具与 众IT业务MCP服务器.

当前集成

  • Proxmox VE --VM/容器/存储/快照/备份管理（约40个工具）

建筑

  • FastMCP（Python 3.11）
  • GCP Cloud Run（澳大利亚东南部1）
  • API密钥验证通过 MCP_API_KEYS env-var或GCP密钥管理器
  • 用于Proxmox连接的Cloudflare隧道（无需端口转发）

环境变量

变量 描述
PROXMOX_HOST Proxmox主机/带端口的隧道主机名（例如。 proxmox.yourdomain.com 或 192.168.1.x:8006)
PROXMOX_TOKEN_ID API令牌ID（例如。 root@pam!homelab)
PROXMOX_TOKEN_SECRET API令牌机密UUID
PROXMOX_VERIFY_SSL false 用于自签名证书（homelab默认）
MCP_API_KEYS 用于身份验证的逗号分隔的API密钥

部署

推到 main 自动触发云构建→ 云运行部署。

# Set env vars on Cloud Run
gcloud run services update homelab-mcp-server \
  --region australia-southeast1 \
  --update-env-vars \
  PROXMOX_HOST=proxmox.yourdomain.com,\
  PROXMOX_TOKEN_ID=root@pam!homelab,\
  PROXMOX_TOKEN_SECRET=your-uuid,\
  PROXMOX_VERIFY_SSL=false

添加到克劳德

添加到您的Claude MCP设置中：

https://homelab-mcp-server-[hash]-ts.a.run.app/mcp?api_key=YOUR_KEY

相关 MCP