Home MCP starter

一个轻量的 Streamable HTTP MCP 服务器，你可以在家用机器或 NAS 上运行，并连接到 Kody。工具在此进程中执行。Kody 通过 CIMD OAuth 经 HTTPS 访问它们。官方 Kody 指南是 连接家庭 MCP 服务器。

家庭笔记作为可替换的示例界面随附。Fork 这个仓库，把这些工具换成你真正想要的 LAN API 和本地 CLI，然后通过 Cloudflare Tunnel 和 Access 发布主机。

使用场景

• 在同一台机器上维护一个私有笔记文件（或 Obsidian 仓库的 sidecar）

• 驱动只在 LAN 上响应的家庭设备

• 封装你的笔记本电脑已经信任的本地 CLI

• 在 NAS 共享目录旁托管自动化任务

Kody 运行在云端。它无法打开你网络上的 localhost。这个服务器就是那个可以访问的进程，而公开的 MCP URL 就是 Kody 拨入的方式。参见 使用场景。

Related MCP server: mcp-devtools

快速开始

本地开发

需要 Node 24。

cp .env.example .env
npm install
npm run dev

状态页面是 http://127.0.0.1:4040/。健康检查是 /health。MCP 是 /mcp。

Docker

cp .env.example .env
# Set HOME_MCP_PUBLIC_BASE_URL to the HTTPS hostname you will publish.
docker compose up --build -d

参见 Docker 了解卷、NAS 风格的 Container Manager 说明以及镜像更新。

文档

• 入门指南

• 使用场景

• Docker

• Cloudflare Tunnel

• Cloudflare Access

• OAuth 和 CIMD

• 添加工具

• 连接 Kody

连接到 Kody

1. 将此进程发布到 HTTPS 主机名（Tunnel + Access）。

2. 打开 /account/mcp-servers。

3. 将服务器添加为 home，使用你的公开 /mcp URL。

4. 打开授权 URL，如果提示则通过 Access，然后批准。

5. 在 mcp:home 下搜索能力。

详细信息见 连接 Kody。

安全

• MCP 客户端使用仅 CIMD 的 OAuth 和 PKCE S256 进行身份验证。没有 动态客户端注册端点。

• RFC 8707 resource 参数必须等于此服务器的 MCP URL。

• Cloudflare Access 保护人类路径（/authorize、/）。机器路径 （/mcp、/token、/revoke、/.well-known、/health）保持可访问，以便 Kody 可以完成 OAuth 并调用工具。Access 不能替代 MCP OAuth。

• LAN 来源是受信任的。不要暴露不受限制的 shell。保持工具 范围狭窄。

• 每个 Kody 账户签发一个 OAuth 授权。不要跨账户共享 bearer token。

社区

Kody 是 Kent C. Dodds 的角色。这是来自 kody-bot 的官方家庭 MCP starter。