adrkit MCPとは？
adrkit はアーキテクチャ決定記録（ADR、設計上の選択とその理由を記録した短い文書）を型付きのデータとして扱います。git 上の Markdown ファイルに YAML フロントマター、accepted・rejected・superseded などのステータス、各決定をパスやパッケージに結びつける affects フィールドを持たせます。@adrkit/mcp パッケージはローカルの stdio サーバーで、エージェントはこのコーパスを検索し、記録を取得し、ファイル群を統制する決定を一覧し、置き換えられたものを一覧できます。
プロジェクトは Mark Beacom（GitHub ユーザー mbeacom）によるもので、Apache-2.0 ライセンス、Node 22 以降向けに TypeScript で書かれています。公式 MCP レジストリには dev.adrkit/mcp として登録されています。バージョン 0.20.0 は 2026年10月11日に公開され、リポジトリのスターは 24、最後の push は 11月7日でした。同じモノレポには CLI、プルリクエストに該当する決定をコメントする GitHub Action、Claude Code と Copilot 向けのプラグインも含まれます。
adrkit MCPのインストール方法
npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adradrkit MCPは使う価値があるか？
adrkit のサーバーの要は「墓場」です。list_superseded と get_decision_context の履歴セクションは、採用された決定と並べて却下・置換された決定も返します。そのため src/db/ への変更を計画するエージェントは、MySQL を再提案する前に、MySQL が試されて置き換えられたことを知ります。汎用のメモリサーバーはエージェントが保存すると決めたものを保持しますが、このサーバーは人がレビューしてマージした記録を読みます。
公開するのは 4 つのツールで、すべて読み取り専用かつクローズドワールドと注記されています。search_decisions（id、タイトル、タグ、本文に対するリテラルな部分文字列検索）、get_decision、リポジトリ相対で最大 256 ファイルを対象にする get_decision_context、list_superseded です。get_decision_context はパスを各記録の affects パターンと照合するだけで、ファイルを開くことはありません。結果は既定で 20 件ずつ、最大 100 件でページ分割され、64 KiB を超える記録は切り詰めず、指摘付きで除外されます。これによりコンテキストのコストは小さく予測可能に保たれます。
注意点：価値は、ほとんどのチームが持っていないコーパスに完全に依存します。記録には adrkit のフロントマターが必要で、ファイルとの照合には手入れされた affects フィールドも要ります。adr migrate --from madr で既存の MADR コーパスに追加できますが、パターンは誰かが書かなければなりません。プロジェクトは 1.0 前で、README 自体がバージョンの固定を求めています。検索はリテラルな部分文字列一致で、設計上ランキングも埋め込みもないため、エージェントは記録で使われている語を推測する必要があります。エージェント用プラグインは意図的に MCP 設定を同梱していません。Copilot CLI がプラグインのサーバーをリポジトリの外で起動するためで、各プロジェクトが自分でサーバーを組み込みます。
セキュリティ面では、MCP サーバーとしてほぼ最も範囲が狭い部類です。一つの git ワークツリー内の一つのディレクトリ配下にある Markdown を読み、シンボリックリンクによる脱出を拒否し、モデルやネットワークへの呼び出しをせず、ポートを開かず、何も書き込みません。プロンプトインジェクションの入口は記録の本文そのもので、リポジトリにマージできる人なら誰でも編集できます。コンテナイメージに含まれる別の REST サーバーは事情が異なります。誰も認証せず、README はそのポートに到達できる人なら誰でも、提供されるすべてのコーパスを読めると警告しています。
真価を発揮する場面
docs/adr に 60 件の ADR を持つ 8 人のプラットフォームチーム
チームが昨年却下したキューシステムをコーディングエージェントが再提案するのを防ぐ
プロジェクトの .vscode/mcp.json か Claude の設定にサーバーを追加し、計画の前にファイルに対して get_decision_context を呼ぶようエージェントに指示します。却下された記録は履歴に表示されます。無料で、必要なのは migrate の実行 1 回といくつかの affects パターンの記述です。
エージェントが書いた計画をレビューするスタッフエンジニア
提案された変更がどの採用済みの決定に触れるかを確認する
エージェントに計画が変更するファイルを列挙させて get_decision_context を呼ばせ、続いて該当する各記録に get_decision を呼ばせて制約を引用させます。同じ答えをプルリクエストに投稿する GitHub Action と組み合わせられます。
MADR ファイルのある顧客のコードベースを引き継ぐコンサルティング会社
ナレッジベースを構築せずに、顧客の決定履歴をエージェントに渡す
adr migrate --from madr を実行して adrkit のフロントマターをその場で追加し、--cwd で adrkit-mcp をリポジトリに向けます。スキーマは上位互換なので、元の MADR ツールもそのまま使えます。
導入前に確認すること
- 導入
- Node 22+ で npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr を実行するか、ghcr.io/mbeacom/adrkit イメージを mcp と読み取り専用マウントで使います。README の設定例は Claude Desktop、VS Code、Cursor、GitHub Copilot CLI を扱っています。--cwd は git ワークツリーのルートでなければなりません。
- 連携
- 読み取り専用の 4 ツール、search_decisions、get_decision、get_decision_context、list_superseded です。stdio で 2025 年版と 2026-07-28 版の MCP プロトコルの両方に対応します。プロジェクト全体では CLI、プルリクエスト用 Action、Spec Kit 拡張、エージェント用プラグインも提供します。
- データとプライバシー
- 一つのリポジトリ内の一つの ADR ディレクトリ配下の Markdown 記録を読み、シンボリックリンクによる脱出を realpath で確認します。書き込み、モデル呼び出し、ネットワークアクセス、永続的な索引はなく、ポートもありません。エージェントは記録の本文を信頼するので、docs/adr へのマージ権限はそれを踏まえて扱ってください。コンテナの別の REST サーバーには認証がありません。
- 大規模利用時のコスト
- Apache-2.0 で無料です。tools/call のたびにコーパスを読み直すので、コストはローカルのファイル読み込みだけで、出力ページは 100 件が上限です。
- 制限
- 未解決の issue は約 12 件です。検索はリテラルのみ、置換関係は 1 段階しかたどらず、フェデレーションされた log:id 参照は認識されても解決されません。サーバー 1 つにつきコーパスは 1 つで、Copilot CLI のプラグインホストからは起動できません。
良い点
- 却下・置換された決定を示す
- 読み取り専用の 4 ツール、ネットワーク・モデル・書き込みなし
- パターンでファイルを統制する決定に対応づける
- 上限付きでページ分割された出力でコンテキストを小さく保つ
気になる点
- adrkit 形式の ADR コーパスがなければ役に立たない
- リテラルな部分文字列検索のみでランキングなし
- 1.0 前で、プロジェクト自身がバージョン固定を勧めている
- 各プロジェクトが自分でサーバーを組み込む必要がある
おすすめの人
すでに git でアーキテクチャ決定記録を管理していて、コーディングエージェントに設計を提案する前にそれを確認させたいチームに向いています。
adrkit MCPの代替
adrkit MCP：よくある質問
- adrkit MCPは使う価値があるか？
- チームがすでに却下した道からエージェ ントを遠ざけるという一つのことをうまくこなす、小さく厳密に読み取り専用のサーバーです。ただし決定が adrkit の形式で書かれていることが前提です。 評価は5点満点中3.6点です。
- adrkit MCPの料金は？
- 無料のオープンソース（Apache-2.0、スキーマは CC0 でもあります）です。ホスト型サービスや有料プランはありません。
- adrkit MCPの欠点は？
- adrkit 形式の ADR コーパスがなければ役に立たない; リテラルな部分文字列検索のみでランキングなし; 1.0 前で、プロジェクト自身がバージョン固定を勧めている; 各プロジェクトが自分でサーバーを組み込む必要がある.
- adrkit MCPは誰に向いているか？
- すでに git でアーキテクチャ決定記録を管理していて、コーディングエージェントに設計を提案する前にそれを確認させたいチームに向いています。
- チームや本番環境でadrkit MCPを使うと費用はいくらか？
- Apache-2.0 で無料です。tools/call のたびにコーパスを読み直すので、コストはローカルのファイル読み込みだけで、出力ページは 100 件が上限です。
- adrkit MCPは企業データを扱っても安全か？
- 一つのリポジトリ内の一つの ADR ディレクトリ配下の Markdown 記録を読み、シンボリックリンクによる脱出を realpath で確認します。書き込み、モデル 呼び出し、ネットワークアクセス、永続的な索引はなく、ポートもありません。エージェントは記録の本文を信頼するので、docs/adr へのマージ権限はそれを踏まえて扱ってください。コンテナの別の REST サーバーには認証がありません。
- adrkit MCPの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はMCP Memory Keeper, Memory (reference server) 、 codebase-memory-mcpです。
回答確認日：2026年11月11日