Home MCP starter

Небольшой Streamable HTTP MCP-сервер, который вы запускаете на домашней машине или NAS и подключаете к Kody. Инструменты выполняются на этом процессе. Kody обращается к ним по HTTPS после CIMD OAuth. Официальное руководство Kody: Подключение домашнего MCP-сервера.

Домашние заметки поставляются как поверхность replace-me. Форкните репозиторий, замените эти инструменты на LAN API и локальные CLI, которые вам действительно нужны, затем опубликуйте хост с помощью Cloudflare Tunnel и Access.

Варианты использования

• Храните приватный файл заметок (или sidecar-файл Obsidian vault) на той же машине

• Управляйте домашними устройствами, которые отвечают только в локальной сети

• Оберните локальный 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 — /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: тома, заметки по Container Manager для NAS и обновления образов.

Документация

• Начало работы

• Варианты использования

• Docker

• Cloudflare Tunnel

• Cloudflare Access

• OAuth и CIMD

• Добавление инструментов

• Подключение Kody

Подключение к Kody

1. Опубликуйте этот процесс на HTTPS-хосте (Tunnel + Access).

2. Откройте /account/mcp-servers.

3. Добавьте сервер как home с вашим публичным URL /mcp.

4. Откройте URL авторизации, пройдите Access, если будет предложено, и подтвердите.

5. Ищите возможности в разделе mcp:home.

Подробности — в Подключение Kody.

Безопасность

• MCP-клиенты проходят аутентификацию через CIMD-only OAuth и PKCE S256. Эндпоинт динамической регистрации клиентов отсутствует.

• Параметр resource из RFC 8707 должен быть равен MCP URL этого сервера.

• Cloudflare Access защищает пользовательские пути (/authorize, /). Машинные пути (/mcp, /token, /revoke, /.well-known, /health) остаются доступными, чтобы Kody мог завершить OAuth и вызывать инструменты. Access не заменяет MCP OAuth.

• Источник в локальной сети считается доверенным. Не открывайте доступ к неограниченному shell. Держите инструменты узконаправленными.

• Выдавайте одно разрешение OAuth на аккаунт Kody. Не передавайте bearer-токен между аккаунтами.

Сообщество

Kody — персонаж Kent C. Dodds. Это официальный домашний MCP-стартер от kody-bot.