homelib (Meltforce)

MCPAI代理

提供方 meltforce

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

Homelib是一款基础设施数据聚合服务,可从多个来源收集基础设施数据并通过Web UI、JSON API和MCP服务器提供统一视图。

一句话选型结论

按资料字段整理

homelib (Meltforce) 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 13 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量13暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

基础设施管理Go本地部署数据聚合Tailscale集成MCP协议Web仪表板

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
homelib (Meltforce)当前 13 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方meltforce上游标注的维护方 meltforce
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.3 KB
来自项目仓库与上游目录的原文,未做删改

homelib

Homelab库存服务从多个来源收集基础设施数据,并通过web UI、JSON API和MCP服务器提供统一的视图。

Homelib将Proxmox、Tailscale、Hetzner Cloud、Komodo和UniFi的主机、服务、网络和容量数据聚合到一个SQLite数据库中。它通过以下方式作为Tailscale节点运行 终端交换网络 --不需要反向代理或身份验证层。

> 注: 这是一个为我自己的家庭实验室建立的个人副项目。它按原样发布,可能看不到定期更新或主动维护。

特性

  • 多源采集 -Proxmox(SSH)、Tailscale(本地+控制平面API)、Hetzner Cloud、Komodo、UniFi
  • MCP服务器 --通过以下方式集成AI/代理的13个工具 模型上下文协议,可从Claude、Claude Code或任何MCP客户端使用
  • 网页用户界面 --仪表板、主机浏览器、服务、网络、Tailscale ACL查看器、容量规划器
  • 应用程序接口 -具有过滤和搜索功能的完整REST API
  • 主机合并 --对从多个来源发现的主机进行重复数据消除和合并
  • 交叉引用 --验证跨源的区域分配,生成不匹配的发现
  • 产能规划 --使用可用容量和区域聚合进行每节点CPU/内存分配跟踪
  • 角色充实 --通过配置为主机标记基础设施角色和应用程序类别
  • 插件系统 --使用输出JSON的自定义脚本(本地或SSH)扩展集合
  • 预定收款 --基于Cron的可配置保留
  • 优雅降级 --失败的收集器不会阻止其他收集器

截图

MCP服务器

Homelib公开了一个 模型上下文协议 服务器在 /mcp (流式HTTP)。这让人工智能助手可以直接查询您的基础设施——询问容量、查找主机、在库存中搜索或触发集合。

工具 说明
list_hosts 列出具有筛选功能的主机
get_host 按名称列出的主机详细信息
list_services Docker服务,按主机/堆栈过滤
list_networks UniFi网络/VLAN
get_acl_policy Tailscale ACL策略
get_dns_config 尾标DNS配置
get_routes 尾标子网路由和出口节点
list_findings 按来源/严重程度列出的基础设施调查结果
get_summary 高级库存统计
search_inventory 所有数据的自由文本搜索
get_collection_status 当前/最新收款状态
trigger_collection 启动新收藏
get_capacity 按节点/区域列出的容量报告

与克劳德一起使用

要将homelib的MCP服务器与Claude.ai或其他远程MCP客户端一起使用,请参阅 tsmcp --一个网关,通过OAuth身份验证在互联网上公开基于tsnet的MCP服务器(如homelib)。

对于您Tailscale网络上的Claude Code或其他本地MCP客户端,请直接指向 https://.your-tailnet.ts.net/mcp.

设置

Homelib通过tsnet作为自己的节点加入您的Tailscale网络。在第一次开始时,它需要一个 尾标认证密钥 注册。之后,tsnet将保持其状态并自动重新连接。

1.创建Tailscale身份验证密钥

在中生成可重用的身份验证密钥 Tailscale管理控制台.将其设置为 ts_auth_key 在您的配置中或作为 HOMELIB_TS_AUTH_KEY 环境变量。

2.创建配置```bash

cp config.example.yaml config.yaml


编辑 `config.yaml` --启用所需的收集器,并为其API配置机密。看 配置 了解详情。

### 3.跑步

#### Docker Compose(推荐)```yaml
services:
homelib:
image: meltforce/homelib:latest
restart: unless-stopped
volumes:
- ./data:/data
environment:
- HOMELIB_TS_AUTH_KEY=tskey-auth-xxxxx  # only needed on first start

放置您的 config.yaml 在 ./data/config.yaml那么:```bash
docker compose up -d


一旦homelib在Tailscale注册,您就可以删除 `HOMELIB_TS_AUTH_KEY` 变量。

#### Docker运行```bash
docker run -d \
--name homelib \
--restart unless-stopped \
-v $(pwd)/data:/data \
-e HOMELIB_TS_AUTH_KEY=tskey-auth-xxxxx \
meltforce/homelib:latest

二进制```bash

go build -o homelib .

Development (localhost:8080, no Tailscale)

./homelib --local --config config.yaml

Production (tsnet)

export HOMELIB_TS_AUTH_KEY=tskey-auth-xxxxx
./homelib --config config.yaml


### 4.访问权限

运行后,homelib可在 `https://.your-tailnet.ts.net` (默认为配置中的主机名 `homelib`).无需端口转发或反向代理——访问由您的Tailscale ACL控制。

## 配置

复制 `config.example.yaml` 并编辑以匹配您的环境。所有的秘密都通过一个链来解决:

1. 环境变量 `HOMELIB_` (例如。 `HOMELIB_HETZNER_API_TOKEN`)
1. 在首尔贸易中心 秘密商店(如果 `secret_backend.type: setec`)
1. 1Password命令行界面 `op://` 引用(如果值以开头 `op://`)
1. 字面值

### 收集器

|收集器|来源|收集的数据|
|-----------|--------|----------------|
| **尾鳞** |tsnet本地API+控制平面API |设备,联机状态,ACL,DNS配置,子网路由|
| **Proxmox** |通过Tailscale进行SSH |节点、VM、LXC容器、CPU/内存/磁盘、状态|
| **赫茨纳** |云API |服务器、规格、定价、防火墙|
| **科莫多** |API | Docker堆栈、容器、图像|
| **统一的** |控制器API | VLAN、子网、DHCP、网络设备|

Tailscale收集器始终处于活动状态-homelib通过tsnet在Tailscale上运行,并使用本地API作为其主要数据源。其他收集器可以独立启用/禁用。所有收集器同时运行。

### 角色

通过以下方式用应用程序和类别元数据丰富发现的主机 `roles` 部分。应用程序和类别显示在主机表、容量页面和主机详细信息视图中。```yaml
roles:
application_categories:
jellyfin: media-server
immich: photos
vaultwarden: security

guest_overrides:
my-vm: homeassistant    # when hostname != application name

tailscale_devices:
my-nas:
role: fileserver
application: truenas

proxmox_nodes:
my-node:
infrastructure_role: hypervisor
workload_specialization: general

插件

使用返回JSON的脚本扩展homelib。插件在本地或通过SSH运行,可以贡献主机、发现和指标。```yaml
plugins:
- name: my-plugin
enabled: true
type: ssh # or "local"
host: my-server
user: root
command: /usr/local/bin/my-script --json
timeout: 30s
schedule: default


插件输出架构:```json
{
"plugin": "my-plugin",
"version": "1.0",
"hosts": [
{ "name": "host1", "host_type": "vm", "details": {} }
],
"metrics": { "metric_name": "value" },
"findings": [
{ "severity": "warning", "host_name": "host1", "message": "High memory usage" }
]
}

REST API

所有端点都在 /api/v1/。响应是JSON。

方法 端点 描述
得到 /api/v1/hosts 列出主机(筛选器: source, zone, status, type, q)
得到 /api/v1/hosts/{name} 主机详细信息及相关服务
得到 /api/v1/services 列出服务(筛选器: host, stack)
得到 /api/v1/networks 列出网络/VLAN
得到 /api/v1/findings 列出调查结果(筛选器: source, severity)
得到 /api/v1/summary 库存统计
得到 /api/v1/capacity 容量规划报告
得到 /api/v1/collections 收藏运行历史记录
职位 /api/v1/collections/trigger 触发收集运行

建筑```

config.yaml
|
v
main.go
|-- Store (SQLite, WAL mode)
|-- Orchestrator
| |-- Collectors (Proxmox, Tailscale, Hetzner, Komodo, UniFi)
| |-- Plugins (custom scripts)
| |-- Merge (deduplicate hosts across sources)
| |-- Crossref (validate zones, enrich roles)
| '-- Persist results
|-- Scheduler (cron)
|-- HTTP Server
| |-- Web UI (embedded templates)
| '-- JSON API
'-- MCP Server (/mcp)


## 项目结构```
main.go                    Entry point, tsnet, HTTP server, scheduler
internal/
config/                  YAML config, secret resolution
model/                   Data types (Host, Service, Network, Finding, etc.)
collector/               Collector interface + implementations
crossref/                Zone validation, role enrichment
store/                   SQLite persistence (WAL mode)
capacity/                Capacity planning calculations
scheduler/               Cron scheduling
server/                  HTTP handlers (Web UI + JSON API)
mcp/                     MCP server (Streamable HTTP)
web/                     Embedded templates + static assets

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
homelib (Meltforce) 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

homelib (Meltforce) 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

homelib (Meltforce) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

homelib (Meltforce) 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

homelib (Meltforce) 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

homelib (Meltforce) 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 基础设施管理、Go、Claude。具体工具清单以官方文档为准。

homelib (Meltforce) 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

homelib (Meltforce) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。