Home MCP starter

Un pequeño servidor MCP HTTP Streamable que ejecutas en una máquina doméstica o NAS y conectas a Kody. Las herramientas se ejecutan en este proceso. Kody las alcanza a través de HTTPS después de CIMD OAuth. La guía oficial de Kody es Conecta un servidor MCP doméstico.

Las notas del hogar se incluyen como superficie de reemplazo. Haz un fork del repositorio, cambia esas herramientas por las API de LAN y las CLI locales que realmente quieras, y luego publica el host con Cloudflare Tunnel y Access.

Casos de uso

• Mantén un archivo de notas privado (o un sidecar de bóveda de Obsidian) en la misma máquina

• Controla dispositivos domésticos que solo responden en la LAN

• Envuelve una CLI local en la que tu portátil ya confía

• Aloja automatizaciones junto a un recurso compartido de NAS

Kody se ejecuta en la nube. No puede abrir localhost en tu red. Este servidor es el proceso que sí puede, y la URL pública de MCP es como Kody se conecta. Consulta casos de uso.

Related MCP server: mcp-devtools

Inicio rápido

Desarrollo local

Requiere Node 24.

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

La página de estado es http://127.0.0.1:4040/. La salud está en /health. MCP está en /mcp.

Docker

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

Consulta Docker para volúmenes, notas de Container Manager estilo NAS y actualizaciones de imágenes.

Documentación

• Primeros pasos

• Casos de uso

• Docker

• Cloudflare Tunnel

• Cloudflare Access

• OAuth y CIMD

• Añadir herramientas

• Conectar Kody

Conectar a Kody

1. Publica este proceso en un nombre de host HTTPS (Tunnel + Access).

2. Abre /account/mcp-servers.

3. Añade el servidor como home con tu URL pública /mcp.

4. Abre la URL de autorización, pasa Access si se te solicita y aprueba.

5. Busca capacidades en mcp:home.

Los detalles están en Conectar Kody.

Seguridad

• Los clientes MCP se autentican con OAuth solo CIMD y PKCE S256. No hay un endpoint de registro dinámico de clientes.

• El parámetro resource de RFC 8707 debe ser igual a la URL MCP de este servidor.

• Cloudflare Access protege las rutas humanas (/authorize, /). Las rutas de máquina (/mcp, /token, /revoke, /.well-known, /health) permanecen accesibles para que Kody pueda completar OAuth y llamar a las herramientas. Access no sustituye a MCP OAuth.

• El origen de la LAN es de confianza. No expongas un shell sin restricciones. Mantén las herramientas limitadas.

• Emite una concesión OAuth por cuenta de Kody. No compartas un token de portador entre cuentas.

Comunidad

Kody es el personaje de Kent C. Dodds. Este es el home MCP starter oficial de kody-bot.