Home MCP starter

家庭のマシンや NAS で実行して Kody に接続する、小さな Streamable HTTP MCP サーバーです。ツールはこのプロセス上で実行されます。Kody は CIMD OAuth の後、HTTPS 経由でそれらにアクセスします。公式の Kody ガイドは ホーム MCP サーバーを接続する です。

家庭用ノートが、差し替え用のサンプルとして同梱されています。リポジトリをフォークし、それらのツールを実際に使いたい LAN API やローカル CLI に置き換えてから、Cloudflare Tunnel と Access でホストを公開してください。

ユースケース

• 同じマシン上にプライベートなノートファイル（または Obsidian vault のサイドカー）を置く

• LAN 上でしか応答しない家庭内デバイスを操作する

• ラップトップがすでに信頼しているローカル CLI をラップする

• NAS 共有の隣で自動化をホストする

Kody はクラウドで実行されます。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

ボリューム、NAS スタイルの Container Manager の注意点、イメージの更新については、Docker を参照してください。

ドキュメント

• はじめに

• ユースケース

• 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 で認証します。Dynamic Client Registration エンドポイントはありません。

• RFC 8707 の resource パラメータは、このサーバーの MCP URL と一致する必要があります。

• Cloudflare Access は人間向けパス（/authorize、/）を保護します。機械向けパス（/mcp、/token、/revoke、/.well-known、/health）は、Kody が OAuth を完了してツールを呼び出せるよう、到達可能なままにします。Access は MCP OAuth の代替にはなりません。

• LAN オリジンは信頼されています。無制限のシェルを公開しないでください。ツールは狭い範囲に留めてください。

• Kody アカウントごとに 1 つの OAuth グラントを発行してください。ベアラートークンをアカウント間で共有しないでください。

コミュニティ

Kody は Kent C. Dodds のキャラクターです。これは kody-bot による公式ホーム MCP スターターです。