HomeLab Dashboard MCP Integrated

MCP开发工具

提供方 The-Incredible-Gamma-Man

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

一个基于Homarr的离线自托管仪表板,提供集中管理界面,支持Docker容器、HTTPS安全认证和AI自动化功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

Shell本地部署自托管Docker管理离线应用AI自动化集中认证

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run --rm -d -p <ext_ip_add:port for Caddy to connect to>:8080 --device /dev/<cam location>:/dev/video -e "RS_MODE=USBCAM" -e "RS_USBCAM_VIDEODEVICE=/dev/video" --tmpfs /tmp/hls datarhei/restreamer

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
HomeLab Dashboard MCP Integrated当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

离线HomeLab仪表板(MCP集成)

概述

这个家庭实验室仪表板,基于 霍马尔,为管理整个自托管生态系统提供了一个集中式界面。它利用 卡迪 反向代理子网上的所有Docker容器,同时使用自签名证书强制HTTPS,所有这些都不需要外部互联网访问。

仪表板预先配置了强大的工具,包括 云端下一站, GitLab公司, 三lium, 波特纳, 开放网络用户界面,以及 限流器 用于实时视频监控。Open WebUI与 奥拉玛 通过MCP(模型上下文协议)实现代理AI功能,实现跨应用程序的智能自动化。

为了额外的安全性和用户管理, 钥匙锁 通过单点登录处理集中身份验证和组管理。消除了创建多个帐户和复杂密码策略的需要。

最棒的是,它完全离线工作。 可选的VPN集成(ZeroTier、Tailscale)可以轻松集成,以便在需要时进行远程访问。

每个应用程序都作为一个具有自己域的独立容器运行,允许您在虚拟机或专用硬件设备之间分发应用程序,以实现精细的资源控制。

主要特点

  • ✅ 完全气隙 --在完全离线的环境中工作
  • 🤖 AI 代理 --Olama驱动的模型通过MCP处理应用程序中的任务
  • 🔐 集中式SSO --Keycloak管理所有用户和组
  • 🔒 HTTPS和自签名证书 --默认情况下安全
  • 🚪 对外端口有限 --所有内容都在局域网内部运行
  • 📦 便携式和模块化 --在Debian上测试;易于跨硬件分发
  • 🎯 极其灵活 --轻松添加、删除或自定义应用程序

入门指南

1.```bash
chmod +x launch_dashboard.sh

1.```bash
./launch_dashboard.sh
  1. 坚持使用默认的IP地址、域、端口和域名,直到你知道自己在做什么。
  2. 除非在安装过程中设置密码,否则它将在 docker-compose.yml.
  3. 记得再生你的 客户端密钥 在Keycloak中,复制它并将其粘贴到突出显示的 docker-compose.yml 变量(# &lt;---- Insert from Keycloak).
  4. 现在导航到新 /Downloads/team-platform/ 您可以在其中开始配置生态系统的目录。

安装后指南

证书!

  1. 导出根CA证书
  • 如果您打算从另一台计算机访问门户,则需要复制 rootCA.crt 从 ./certs 并将其安装在该设备上。
  • 无论你在哪里举办 Caddyfile,您需要将其指向每个应用程序 cert 和 key .pem 文件夹。
  • 在向环境中添加新应用程序时,从您启动的计算机 launch_dashboard.sh from,run:```bash
    mkcert
并将2个文件传输到 `/certs` Caddy指向的文件夹。

1. **理解架构**

- 所有应用程序都通过Docker端口在内部HTTP上运行
- Caddy处理HTTPS终止并在端口443上公开服务

### 初始配置步骤

1. 使用登录Keycloak `admin` 密码(位于 `docker-compose.yml`)或者在安装过程中记住设置。
- 如果您在访问Keycloak时遇到问题,请编辑 `docker-compose.yml`,从管理员密码中删除任何特殊字符并运行;
-```bash
docker compose down keycloak &amp;&amp; docker compose up -d keycloak
  1. 点击 创建领域 如果确实使用提供的备份,请导入 realm-export.JSON 从适当的驱动器。
  2. 引导到 领域设置 → 行动 (右上)→ 部分进口
  3. 如果从头开始,请使用专用管理员用户创建一个新域(不要使用默认值 Master 王国!).
  4. 创建用户并将其分配到组。
    - 确保 电子邮件已验证 被选中。
    - 为每个用户添加电子邮件、姓名和密码。
  5. 如果你没有使用 realm-export.JSON 备份文件,您需要映射 groups 到王国角色;
    - 选择 Client Scopes 从左侧菜单。
    - Create Client Scope
    - '名称'= groups · '类型'= Default · '在同意屏幕上显示'= off · '包含在令牌范围内'= on · Save
    - 选择 Mappers tab → Add mapper → From predefined mappers |选择 realm roles, client roles, audience resolve
    - 选择 Add mapper → By configuration → Group Membership · '名称'= groups · '令牌声明名称'= groups · '完整组路径'= off · Save

在局域网中添加新网站

客户端(又名应用程序)配置

  1. 创建一个客户端 客户端身份验证 启用。如果你使用 realm-export.json,您将已经生成了客户端。
  2. 身份验证流程:启用 标准流程 (某些应用程序需要 直接访问 -查看官方文件)。
  3. PKCE方法:除非文件指定S256(SHA256),否则保持未选中状态。
  4. 网址:
    - 根、主页和注销后URL: https://.lan
    - 有效的重定向URI: https://.lan/* 或 https:///oauth/oidc/callback (查看应用程序的官方文档)。
  5. 凭据选项卡:重新生成客户端密钥并将其复制到您的 docker-compose.yml
  6. 客户端范围选项卡:
    - 选择超链接 xxx-dedicated 范围。
    - 添加: username, email, groups 从 添加预定义映射器 列表。
    - 创建 groups 如果它不存在,则通过 配置新映射器 选项;
    - 选择 组成员
    - 姓名= groups
    - 令牌声明名称= groups
    - 完整组路径= off
    - 保存
  7. 现在,对于每个客户端(应用程序),复制 credential secret 并将其粘贴到相应的 docker-compose.yml 文件环境变量(如果需要)。
  8. 同样,在适当的范围内 docker-compose.yml 文件,您可能需要输入 realm-name 如有规定。
  9. 奔跑;```bash
    docker compose down && docker compose up -d

## 特定应用程序设置

### 开放网络用户界面

1. **备份文件**

- `models-xxx.json` → 上传到 **管理设置** → **模型**
- `openwebui-configxxx.json` → 上传到 **管理设置** → **数据库**

1. **管理员设置配置**

- 启用 **新注册**
- 启用 **API** 并为集成和模型设置权限。
- 最低24GB+GPU的推荐型号: `qwen3-coder:30B` 或 `qwen3.5:9b` (4比特量化最小值)。

1. **拉取其他型号**```bash
docker exec ai-ollama ollama pull

云端下一站

  1. 创建本地管理员用户。
  2. 安装 OpenID连接后端 应用程序。
  3. 引导到 OpenID连接 并使用以下设置注册Keycloak:
    - 发现端点: https://keycloak.lan/realms/YOUR_REALM_NAME/.well-known/openid-configuration
    - 反向通道注销URL: https://nextcloud.lan
    - 重定向URI: https://nextcloud.lan
    - 客户端密钥:来自Keycloak证书
    - 提供者: Keycloak
    - 客户端ID:必须与Keycloak完全匹配
    - 范围: openid email profile
    - 额外索赔: preferred_username email name groups

霍马尔

> 重要:某些应用程序需要初始本地管理员用户。

  1. 使用唯一的用户名创建本地管理员用户
  2. 创建一个Homarr管理组,您也可以将其应用于Keycloak(例如。, homarr-admins)
  3. 将您的本地用户添加到应用程序中的此组。
  4. 添加 ./certs/rootCA 证书到 管理 → 工具 → 证书
  5. 请注意,新用户将自动加载到默认值 everyone 需要为新的板和集成提供组和权限。

向霍马尔进发

  • Homarr依赖于video.js,因为它不理解RTSP等原生协议

  • 需要编码器,例如“Restreamer”,才能通过HTTP从H.264转换为HLS或FLV

  • 由于Docker需要通过硬件直接访问连接的摄像头,当摄像头可以在局域网上的任何机器上时,为Restreamer生成Docker compose文件是违反直觉的。
    相反,您将在下面找到2个命令来启动Restreamer。一个用于临时使用,一个用于存储数据。如果您脱机运行,则需要预拉datarhei映像;

  • 临时:```bash
    docker run --rm -d -p :8080 --device /dev/:/dev/video -e "RS_MODE=USBCAM" -e "RS_USBCAM_VIDEODEVICE=/dev/video" --tmpfs /tmp/hls datarhei/restreamer


- 永久的:```bash
docker run -d -p :8080 --device /dev/:/dev/video -e RS_HTTPS=true -e &quot;RS_MODE=USBCAM&quot; -e &quot;RS_USBCAM_VIDEODEVICE=/dev/video&quot; --tmpfs /tmp/hls -v           /mnt/restreamer/db:/core/config -v /opt/restreamer/data:/core/data datarhei/restreamer`
  • 粘贴到Homarr仪表板中的“视频流”项->http:///memfs/.m3u8|也可在凸轮通道下方的限流器上找到,标记为 HLS

  • 如果上述操作失败,请在Homarr中使用“iframe”项,并将Restreamer上的HTML链接粘贴到 Player 配置选项。不是iFrame链接!霍马尔为你管理。

  • 请参阅示例配置:


注意事项

  1. Caddyfile:从添加具有匹配暴露端口的客户端配置 docker-compose.yml(即。 ...ports: &quot;8080:80&quot; = ...端口:“expose_to_caddy:internal_docker”)
  2. 主机文件:更新 /etc/hosts。在大多数情况下,每个域都需要指向Caddy IP。球童是唯一需要知道谁是谁的机器。
  3. 超文本传输安全协议:切勿启用应用内HTTPS或证书使用,因为这一切都是通过Caddy管理的。
  4. 用户自动人口:组和用户详细信息在首次登录时自动填充。除了初始的本地管理员外,不需要在应用程序中创建新用户。

Docker命令

命令 目的
docker ps 检查正在运行的容器的状态
docker exec ai-ollama ollama list 列出Olama车型
docker compose -p team-platform logs -f 跟踪服务日志
docker compose -p team-platform down 停止服务
docker compose -p team-platform up -d 启动服务

> 备注:从包含以下内容的目录中运行compose命令 docker-compose.yml.省略 `` 影响所有服务。

Olama模型管理```bash

Pull a model

docker compose -p team-platform exec ollama ollama pull

List available models

docker compose -p team-platform exec ollama ollama list

Delete a model

docker compose -p team-platform exec ollama ollama rm


______________________________________________________________________

**⚠️ 备注**

- 每 `docker-compose.yml` 环境是独一无二的——有关具体配置,请参阅官方应用程序文档

- 此设置仍在测试中;请报告任何问题或改进

- 大部分工作都是由安装脚本自动完成的!

- 如果您选择在另一台机器上部署应用程序,只需复制相关内容 `docker-compose.yml` 为该应用程序分段并创建新的 `docker-compose.yml` 在该机器上存档并编辑;

- 环境变量中对IP地址的任何引用。
- Caddy接触的端口暴露——如果需要,以避免与其他正在运行的服务发生冲突。
- `/etc/hosts` 应始终指向Caddy IP地址,但托管Caddy的计算机除外-更新此计算机的 `/etc/hosts` 使用新的IP。
- 更新Caddyfile以访问新的主机IP。
- 记得将rootCA.crt上传到新机器上。

- 不要忽视你的防火墙规则!```bash
sudo ufw default deny incoming &amp;&amp; sudo ufw default allow outgoing &amp;&amp; sudo ufw reload

至少。


项目库

*ai-nextcloud-mcp显示为“offline”,直到配置文件中填充了每个应用程序的API密钥

*Docker CPU百分比与正在使用的内核数量有关。100%=1芯


许可证

该项目根据 MIT许可证 -看看 LICENSE 文件以获取完整详细信息。

AI免责声明

大部分内容在 launch_dashboard.sh 脚本是在不同的时间由不同的主机单独生成的。Grok和Claude Sonnet习惯了
协助将这些元素编排到一个文件中,特别是处理复杂的内核级别和权限问题,同时改进脚本的
运行时外观和用户体验。

每一行都经过主要贡献者的仔细审查、编辑和测试,以确保安全性和正确性。没有什么是不受控制的。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
HomeLab Dashboard MCP Integrated 怎么安装?

在客户端按下面的安装命令接入:docker run --rm -d -p <ext_ip_add:port for Caddy to connect to>:8080 --device /dev/<cam location>:/dev/video -e "RS_MODE=USBCAM" -e "RS_USBCAM_VIDEODEVICE=/dev/video" --tmpfs /tmp/hls datarhei/restreamer。装完在客户端配置里引用同一个包或端点。

HomeLab Dashboard MCP Integrated 怎么在 Claude 里配置?

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

HomeLab Dashboard MCP Integrated 收费吗?

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

HomeLab Dashboard MCP Integrated 需要 API Key 吗?

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

HomeLab Dashboard MCP Integrated 支持哪些客户端?

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

HomeLab Dashboard MCP Integrated 能提供哪些能力?

资料显示能力标签包括 Shell、Claude、自托管。具体工具清单以官方文档为准。

HomeLab Dashboard MCP Integrated 需要什么运行环境?

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

HomeLab Dashboard MCP Integrated 是本地还是远程?

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

热门专题

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

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