heorth-mcp

Wyrhta Labs 家の単一 MCP サーバーで、独自のコンテナとして動作します。

データもドメインロジックも所有しません。すべてのツール呼び出しは、上流サービスの公開 REST API への呼び出しに変換されます。つまり、MCP ツールは、認証済みの家庭メンバーが HTTP 経由で既に実行できることしか実行できません。

MCP client ──Streamable HTTP──▶ heorth-mcp ──▶ Heorth REST      (37 tools)
                                           └─▶ KithLedger REST  (13 tools)

ステータス

50 個のツールがすべて移植されました。 37 個の Heorth ツール（household.*、calendar.*、meals.*、library.*、inventory.*、tasks.*、feoh.*）はタスク A5 で、13 個の kith.* ツールはタスク B11 で実装されました。tools/list は、設定された上流が提供するもの（両方、片方、またはどちらも設定されていない場合は何もなし）を提供します。MCP コードは依然として Heorth と KithLedger に埋め込まれており、ここで同等のツールがデプロイされたコンテナに対して検証された後にのみ削除されます。

設定

heorth-mcp は、どちらの上流に対しても独自の資格情報を保持しません。 Heorth への呼び出しは、呼び出し元の Bearer he_... をそのまま伝えます。KithLedger への呼び出しは、heorth-mcp が Heorth（POST /api/v1/auth/satellite-token、ADR 0009）で同じ呼び出し元の資格情報を使用して交換する短命のメンバートークンを保持し、呼び出し元ごとにメモリ内に 5 分弱キャッシュされます。そのため、kith.* には両方の上流が必要です。Heorth が ID 権限であり、到達不能な場合、KithLedger が正常でも kith.* ツールは失敗します（IDENTITY_UNAVAILABLE）。

KITH_API_KEY は廃止されました。KithLedger はメンバーごとのアクセス制御（ADR 0004）を実施しており、3 種類の kl_ 資格情報のいずれも呼び出し元メンバーではありません。member キーは発行アカウント自身のスコープとして読み取られ、household キーは家庭スライスのみを参照し、ops キーにはデータアクセスがまったくありません。

• docs/spec/tool-surface.md — 50 ツールの契約とその REST マッピング

• docs/spec/migration.md — 上流リポジトリから何を、どの順序で移動するか、および各削除の前に何が真でなければならないか

• CLAUDE.md — アーキテクチャ、認証モデル、および規約

メタリポジトリ Wyrhta-Labs/wyrhta-labs 内の ADR 0008 — REST 上のスタンドアロンコンテナとしての MCP によって作成されました。

コンテナイメージ

GitHub Container Registry に ghcr.io/wyrhta-labs/heorth-mcp として .github/workflows/build-image.yml によって公開されています。ワークフローはまず型チェックと完全なテストスイートを実行し、失敗したスイートは公開をブロックしてから、このリポジトリの Dockerfile を linux/amd64 用にビルドします。

公開されるのは 2 つだけです：main へのプッシュと v* の git タグです。それ以外は何も公開されないため、レジストリはブランチのジャンクがありません。

本番環境での固定。 メタリポジトリの deploy/compose.prod.yml は、deploy/.env に明示的なタグを要求します：

HEORTH_MCP_IMAGE_TAG=main-a1b2c3d   # a main build, by short commit sha
HEORTH_MCP_IMAGE_TAG=0.2.0          # a release, once a v0.2.0 tag exists

latest や main を固定しないでください。どちらも実行中のデプロイメントの下で移動し、固定の目的を無効にします。ワークフロー実行（または docker images）に表示される正確な main-<sha> か、リリースのセマンティックバージョンを使用してください。

イメージはリポジトリと同様にプライベートです。プルするホストは、Wyrhta-Labs 組織の read:packages を持つ GHCR ログインが必要です。

関連リポジトリ