Home MCP starter

Ein kleiner Streamable-HTTP-MCP-Server, den du auf einem Heimrechner oder NAS betreibst und mit Kody verbindest. Die Tools werden in diesem Prozess ausgeführt. Kody erreicht sie über HTTPS nach CIMD-OAuth. Der offizielle Kody-Leitfaden ist Einen Heim-MCP-Server verbinden.

Haushaltsnotizen werden als Platzhalter-Oberfläche mitgeliefert. Forke das Repository, tausche diese Tools gegen die LAN-APIs und lokalen CLIs aus, die du wirklich möchtest, und veröffentliche den Host dann mit Cloudflare Tunnel und Access.

Anwendungsfälle

• Eine private Notizdatei (oder einen Obsidian-Vault-Sidecar) auf demselben Rechner aufbewahren

• Heimgeräte steuern, die nur im LAN reagieren

• Ein lokales CLI kapseln, dem dein Laptop bereits vertraut

• Automatisierungen neben einer NAS-Freigabe hosten

Kody läuft in der Cloud. Er kann localhost in deinem Netzwerk nicht öffnen. Dieser Server ist der Prozess, der das kann, und die öffentliche MCP-URL ist der Weg, über den Kody sich einwählt. Siehe Anwendungsfälle.

Related MCP server: mcp-devtools

Schnellstart

Lokale Entwicklung

Erfordert Node 24.

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

Die Statusseite ist http://127.0.0.1:4040/. Health ist /health. MCP ist /mcp.

Docker

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

Siehe Docker für Volumes, NAS-typische Container-Manager-Hinweise und Image-Updates.

Dokumentation

• Erste Schritte

• Anwendungsfälle

• Docker

• Cloudflare Tunnel

• Cloudflare Access

• OAuth und CIMD

• Tools hinzufügen

• Kody verbinden

Mit Kody verbinden

1. Veröffentliche diesen Prozess unter einem HTTPS-Hostnamen (Tunnel + Access).

2. Öffne /account/mcp-servers.

3. Füge den Server als home mit deiner öffentlichen /mcp-URL hinzu.

4. Öffne die Autorisierungs-URL, durchlaufe Access, falls du dazu aufgefordert wirst, und genehmige.

5. Suche unter mcp:home nach Fähigkeiten.

Details findest du in Kody verbinden.

Sicherheit

• MCP-Clients authentifizieren sich mit CIMD-only OAuth und PKCE S256. Es gibt keinen Endpunkt für Dynamic Client Registration.

• Der resource-Parameter aus RFC 8707 muss der MCP-URL dieses Servers entsprechen.

• Cloudflare Access schützt Benutzerpfade (/authorize, /). Maschinenpfade (/mcp, /token, /revoke, /.well-known, /health) bleiben erreichbar, damit Kody OAuth abschließen und Tools aufrufen kann. Access ist kein Ersatz für MCP-OAuth.

• Der LAN-Ursprung ist vertrauenswürdig. Lege keine uneingeschränkte Shell offen. Halte die Tools eng begrenzt.

• Stelle pro Kody-Konto eine OAuth-Genehmigung aus. Teile kein Bearer-Token zwischen Konten.

Community

Kody ist die Figur von Kent C. Dodds. Dies ist der offizielle home MCP starter von kody-bot.