Decantr Mcp Server

@decantr/mcp-server

サポート状況：core-supported
リリースチャンネル：stable

Changed-UI Assurance、ローカルプロジェクトの状態、権限を考慮したルートおよび非ルートのタスクコンテキスト、グラフとエビデンスの読み取り、修復プロンプトに対応する、安定版 Decantr 3.11.3 MCP 統合です。

リリースの範囲

公開済みの npm パッケージは 3.11.3 です。8 つのツール ID、ルートに基づく TaskCapsuleV1 パス、権限を考慮したターゲットの検出、検証アクション、互換性エンベロープは安定版です。既存の decantr_verify ツールにアクション changes が追加されました。このアクションは、基本の CLI verify および明示的な CI v3 で使われるものと同じ change-assurance-report.v1 を返します。9 つ目のツールは追加されません。

• プロジェクトの状態を確認 -- 共有の検出メタデータ、プロジェクト所有の Contract、適用済みのローカルルール、型付きグラフ、採用状況の実態を調べます
• ルートのコンテキストを準備 -- 現在のグラフと本番ルートの権限を通じて、関連付けられたルートを解決し、ソースの順位付けを行った簡潔なタスクカプセルを作成します
• 差分を検証 -- 利用可能な権限に照らしてローカルの作業を評価し、ソースをアップロードせずに、安定した検出結果、健全性の状態、エビデンスを返します
• 報告と修復 -- 型付きエビデンス、範囲を限定した修復計画、任意のコーディングエージェントが利用できる修復プロンプトを提供します

Decantr はエージェントを呼び出したり、編集内容を生成したり、ホストプロジェクトのデザインシステムを置き換えたりすることはなく、ローカルのワークフローでアカウントを必要としません。

クイックセットアップ

Claude Desktop

Claude Desktop の設定に追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "decantr": {
      "command": "npx",
      "args": ["@decantr/[email protected]"]
    }
  }
}

Claude Desktop を再起動します。Decantr のツールが自動的に表示されます。

Cursor

推奨セットアップ：

npx @decantr/[email protected] connect cursor

モノレポのルートから実行する場合：

pnpm exec decantr connect cursor --project apps/web

このコネクターは既存の MCP サーバーを保持し、ルートを編集する前にルートに基づく Decantr のタスクコンテキストをリクエストするよう Cursor Agent に指示するプロジェクトルールを書き込みます。手動でセットアップする場合は、プロジェクトのルートに .cursor/mcp.json を作成します：

{
  "mcpServers": {
    "decantr": {
      "command": "npx",
      "args": ["-y", "@decantr/[email protected]"]
    }
  }
}

Cursor を再起動します。ツールは Agent モードで利用できます。MCP を手動で設定する場合は、decantr connect cursor と同等のプロジェクトルールを追加してください。

Windsurf

Windsurf の MCP 設定に追加します（~/.windsurf/mcp.json）：

{
  "mcpServers": {
    "decantr": {
      "command": "npx",
      "args": ["@decantr/[email protected]"]
    }
  }
}

VS Code

ワークスペースに .vscode/mcp.json を作成するか、ユーザープロファイルの mcp.json に追加します：

{
  "servers": {
    "decantr": {
      "command": "npx",
      "args": ["-y", "@decantr/[email protected]"]
    }
  }
}

MCP ツールは VS Code Copilot Chat のエージェントモードで利用できます。

Zed

Zed の settings.json に追加します：

{
  "context_servers": {
    "decantr": {
      "command": "npx",
      "args": ["-y", "@decantr/[email protected]"],
      "env": {}
    }
  }
}

Continue.dev

ワークスペースに .continue/mcpServers/decantr.yaml を作成します：

name: Decantr MCP Server
version: 0.0.1
schema: v1
mcpServers:
  - name: Decantr
    type: stdio
    command: npx
    args:
      - "-y"
      - "@decantr/[email protected]"

MCP ツールは Continue.dev のエージェントモードでのみ利用できます。

主なツール

サーバーが公開する MCP のツールは、厳密に 8 つです。action を指定して、ルーティングされる動作を選択します。

ツール	説明	入力例
decantr_project	ローカルプロジェクトの状態、共有ディスカバリーの概要、採用状況の実態、ワークスペースの健全性を読み取ります	{ "action": "state", "project_path": "apps/web" }
decantr_contract	プロジェクト所有の Contract の読み取りと検証、ドリフトの調査、互換性スケルトンの作成、またはそのカプセルの読み取りを行います	{ "action": "validate", "path": "./decantr.essence.json" }
decantr_context	スキャフォールド、セクション、ページ、実行パックのコンテキストを読み取るか、ルートに紐付いたタスクカプセルを準備します	{ "action": "task", "project_path": "apps/web", "route": "/feed", "task": "improve loading behavior" }
decantr_graph	ルートを対象とする作業のために、ローカルグラフとソースエビデンスを読み取り、クエリし、たどります	{ "action": "query", "project_path": "apps/web", "file_path": "src/app/page.tsx", "include_impact": true }
decantr_registry	旧名称を含む互換性アクセスにより、公式コーパスの語彙、ベンチマークメタデータ、実行パックを利用します	{ "action": "resolve_pattern", "id": "data-table", "preset": "product" }
decantr_verify	Changed-UI Assurance、批評、検出事項、健全性状態、または v2 エビデンスバンドルを返します	{ "action": "changes", "project_path": "apps/web" }
decantr_repair	型付きの検出事項を、対象を絞った修復計画、プロンプト、v2 健全性ループのガイダンスに変換します	{ "action": "health_loop", "project_path": "apps/web" }
decantr_contract_write	ドリフトの受け入れや Essence v4 の更新を行う、ワークスペース内に限定された明示的な書き込み機能です	{ "action": "update_essence", "operation": "add_feature", "payload": { "feature": "billing" } }

紐付けられたルートについては、task アクションに route または互換性のある page_id を渡します。コンパクトモードでは、検証器が所有する TaskCapsuleV1 を既存の応答フィールドに投影し、正規化 UTF-8 バイト数で 12,000 バイト、推定トークン数で 4,000 トークン以内に収めます。SvelteKit のルート読み取りでは、+page.svelte を最初に扱い、同じ場所にあるページデータモジュールは補助的な根拠として扱います。グラフのエビデンスが欠落または古い場合は blocked_missing_graph を報告します。Angular の本番ルートに関する根拠が不完全な場合は DISCOVERY_NOT_PROVEN を報告します。どちらの場合も、推測によって実装ソースを選択することはありません。

pack-manifest.json で選択されたローカルのスキャフォールド、ページ、セクションのパスは、選択したプロジェクトの .decantr/context ディレクトリ内に実在するファイルとして解決できる場合にのみ、タスクの読み取り対象として読み取るか出力します。欠落している参照、ディレクトリへの参照、範囲外の参照、シンボリックリンクを経由して範囲外に解決される参照は無視します。既存の scaffold.md と section-<id>.md の説明コンテキストは、引き続きローカルのフォールバックとして使用されます。Greenfield の style-bridge 採用では、受け入れられたブリッジをホストプロジェクトのトークン、クラス、スタイリングランタイムに対応付けます。@decantr/css を有効にするものではありません。

decantr_project の状態には、検証器が構築した AdoptionTruthV1 が含まれます。互換性を示す名称の decantr_registry ツールにおける公式コーパスのアクションは、@decantr/content の実装を使用します。9 番目の decantr_content ツールはありません。

decantr_verify の changes アクションは、書き込みを行わず、採用処理も行いません。現在の Git の変更を解決し、証明できる場合に限り、変更された UI アプリを 1 つ選択して、デフォルトで重大な検出事項を最大 3 件出力します。複数アプリの曖昧さ、Git の対象範囲を利用できない状態、根拠が未解決の状態では、not_proven を返します。プリミティブ再利用の保証は 3.11 では JSX/TSX で最も強く、テンプレートの同等性確認には引き続き制限があります。

3.10 権限を考慮した検出

decantr_context タスク入力では、target にルートパス、正確なサーフェス ID、コンポーネント名、kind:name、または file:path を指定できます。すべてのターゲットはライブ検証器の検出結果から解決され、保存済みの分析、グラフ上の推測、テスト、フィクスチャ、ストーリー、生成出力が本番ルートの権限ある情報として扱われることはありません。不明、曖昧、推定、未解決、またはタスク実行不可能なターゲットに対しては、編集読み取りセットを伴わないエラーが返されます。

静的に解決されたミドルウェア／プロキシの非成功ポリシーによって非表示になっている Next ファイルルートは、有効な検出サーフェスですが、タスク実行可能な MCP ターゲットではありません。そのポリシーがパスに依存し、解決できない場合、タスク準備では慣例だけでルートを選択せず、権限がブロックされている状態を返します。TanStack の生成メタデータは、作成者が定義したルートの公開パスを裏付けることはありますが、実装ターゲットではなく、参考情報にとどまります。Astro のレスポンスエンドポイントと TanStack／Angular のレイアウトまたはフォールバックは、引き続きタスク実行不可能です。SvelteKit のページデータモジュールは引き続きタスク実行不可能であり、同じディレクトリにある +page.svelte の実装のみを補助できます。Angular のタスク読み取りには、静的に解決された外部テンプレート、コンポーネントのスタイル、ワークスペースのセカンダリエントリーソースが含まれます。優先順位付けされたスタイルの読み取りでは、ワークスペースパッケージのエクスポートを含め、本番 CSS のインポート順が維持されます。付属のルート互換性レスポンスには CLI と同じ検証器優先順位の読み取りセットが含まれ、変更ソースへの影響から生成されたガバナンス関連の変更は除外されます。また、タスクカプセルの予算を超える前に、互換性専用の詳細情報が削除されます。

権限が確定した非ルートターゲットと未採用のターゲットでは、読み取り範囲に上限を設け、制限事項を明示した別個の ui-surface-task-context.v1 検出エンベロープが返されます。スタンドアロンのコンポーネントやストーリーは、プロジェクト参照情報にとどまり、実行時の到達可能性を証明するものではありません。採用済みのルートでは、引き続き互換性のある TaskCapsuleV1 コントラクトが使用されます。

製品の境界

MCP サーバーの中核は、ローカルの Observe -> Prepare -> Verify -> Report ループです。以下のサーフェスは、互換性上必要な場合にのみ引き続き利用できます。

• decantr_registry は、公式コンテンツコーパスの読み取りに使用する安定した 3.x ツール ID です。公開レジストリ、マーケットプレイス、またはコミュニティによる公開サーフェスではありません。
• @decantr/css は任意のレガシーアダプターです。自動選択されることはなく、ホストプロジェクトのスタイリング権限を上書きしません。
• Studio は、Decantr のエビデンスを読み取り専用で利用する非中核機能です。この MCP サーバーの使用に必須ではありません。
• ホストされたコンテンツとインテリジェンスのメタデータは、任意の互換性入力です。ローカルプロジェクトの権限、ローカル検証、エビデンスのレポートに、ホストされたソース分析や Decantr アカウントは必要ありません。

より広範な製品サーフェスとサポートポリシーについては、Decantr のルートドキュメントとパッケージサポートマトリックスをご覧ください。

Decantr 3 のアシスタントプロンプトの移行については、MCP 移行ガイドをご覧ください：https://decantr.ai/reference/mcp-migration.md。

セキュリティと権限

MCP サーバーは、.decantr/graph の型付きグラフ成果物を含む Decantr ファイル、選択されたプロジェクトファイル、変更範囲の特定に使用するローカル Git コマンド経由の Git メタデータ、コンポーネントの権限ある情報として使用される、直接参照されたワークスペースパッケージのソースを読み取ります。書き込みアクセスは、明示的な decantr_contract_write ツールの accept_drift および update_essence アクションに限定されます。呼び出し元がその解決方法を明示的に要求した場合、accept_drift は検出事項を .decantr/drift-log.json に先送りすることがあります。パスはアクティブなワークスペースのルート内に制限されます。

コンテンツコーパスとパック解決のアクションでは、設定済みの Decantr API が呼び出されることがあります。プロジェクトの権限、批評、監査、検証はローカルでの読み取りに限られ、ソースのアップロードによるフォールバックは廃止されています。MCP サーバーは Decantr のテレメトリを送信しません。セキュリティ権限をご覧ください。

npm パッケージには、stdio トランスポートが使用する MCP SDK モジュールがバンドルされています。SDK の未使用の HTTP サーバー依存関係ツリーはインストールされません。バンドルされたコードのライセンスは THIRD_PARTY_NOTICES.md に保持されています。

互換性

@decantr/mcp-server は、文書化された MCP ツールの範囲において Decantr 3 系で安定しています。

• Decantr 3 が提供するのは、上記の8つのツールのみです。9つ目のコンテンツツールや非公開のエイリアスは、このリリース系列と互換性がありません
• 既存の文書化されたツール名とエンベロープは、メジャーバージョンを上げずに変更しないでください
• 確立済みのツール契約に対する破壊的変更には、メジャーバージョンと移行に関する注記が必要です

Decantr 3 のツール範囲

Decantr 3.4 では、従来の MCP ツール名が、上記の8つのアクションベースのツールに統合されました。3.x 系では、ツールの構成、サーバー ID、stdio トランスポート、既存のアクション名、互換性エンベロープが維持されます。公式コーパスとの互換性は、9つ目のツールではなく、decantr_registry を通じて引き続き提供されます。たとえば、decantr_get_project_state は { "action": "state" } を指定した decantr_project に、decantr_get_graph_snapshot は { "action": "snapshot" } を指定した decantr_graph に、従来の書き込みツールは { "action": "accept_drift" } または { "action": "update_essence" } を指定した decantr_contract_write に置き換わります。

npm の tarball には server.json が含まれているため、MCP ディレクトリは、リポジトリの利用者と同じ安定した ID およびトランスポートメタデータを読み取ることができます。

仕組み

公開されている 3.11.3 は、プロジェクトが所有するエビデンスを読み取ります。対象は、Git の変更、アプリケーションのソースとフレームワーク設定、直接参照されているワークスペースコンポーネント、承認済みのローカルルール、存在する場合の decantr.essence.json、グラフの成果物、ベースライン、検証結果です。Brownfield では、本番環境のソースが引き続き最上位の基準となり、承認済みの Essence はその下にあるプロジェクトのルールです。MCP クライアントは、導入なしで Changed-UI Assurance をリクエストしたり、編集前に範囲を限定したタスクコンテキストをリクエストしたり、編集後に検証エビデンスを確認したりできます。Decantr はエビデンスと制限事項を報告し、コード変更の責任はコーディングエージェントが担います。

ワークフローの例

プロンプト：「既存のカードコンポーネントやスタイリングシステムを置き換えずに、/feed の読み込み時とエラー時の動作を改善してください。」

MCP 対応のコーディングエージェントは、次の順序でツールを使用できます。

1. decantr_project に state を指定して、選択されたアプリ、利用可能な基準、グラフの準備状況、導入状況、制限事項を確認します。
2. decantr_context に task と route: "/feed" を指定して、編集前にグラフに基づく簡潔なコンテキストを準備します。
3. decantr_graph に query または traverse を指定して、変更に必要な、順位付けされたローカルソースと影響範囲のエビデンスを取得します。
4. コーディングエージェントは通常のツールを使ってプロジェクトを編集します。Decantr がソースの変更を生成したり適用したりすることはありません。
5. decantr_verify に changes を指定して、まず現在の UI 差分を検証します。より詳細なエビデンスの確認には、audit_project、critique、evidence_bundle、health_loop も引き続き利用できます。
6. decantr_repair で型付きの検出結果を範囲指定された計画または修復プロンプトに変換し、その後、再度検証を実行します。

プロジェクトが Essence 契約を使用している場合は、引き続き decantr_contract を利用できます。タスクで公式コーパスの用語や実行パックが必要な場合は、引き続き decantr_registry を利用できますが、必須のローカルワークフローには含まれません。

ライセンス

MIT