LikeC4

@likec4/mcp

ドキュメント

使い方

{
  "mcpServers": {
    "likec4": {
      "command": "npx",
      "args": [
        "-y",
        "@likec4/mcp"
      ],
      "env": {
        "LIKEC4_WORKSPACE": "${workspaceFolder}"
      }
    }
  }
}

このパッケージは、stdio トランスポートを使用して MCP サーバーを起動します。

LIKEC4_WORKSPACE 環境変数が設定されていない場合は、現在のディレクトリがワークスペースとして使用されます。

CLI としての使い方

グローバルにインストールするか、npx を使用します。

npm install -g @likec4/mcp
likec4-mcp -h

USAGE `likec4-mcp [OPTIONS] [WORKSPACE]`

ARGUMENTS

  `WORKSPACE="."`    change workspace, defaults to current directory, can be set by LIKEC4_WORKSPACE env    <directory>

OPTIONS

          `--stdio`    use stdio transport (this is default)
           `--http`    use streamable http transport
  `--port=<number>`    change http port (default: 33335)
       `--no-watch`    disable watch for changes (consume less resources if you have static workspace)

使用可能なツール

• list-projects：ワークスペース内のすべての LikeC4 プロジェクトを一覧表示します。
• read-project-summary：プロジェクトの仕様、設定、すべての要素、デプロイメントノード、ビューを取得します。
• search-element：すべてのプロジェクトから、ID／タイトル／説明／リンクに基づいて要素とデプロイメントノードをあいまい検索し、関連度順に表示します。種類／形状／タグ／メタデータによる厳密なフィルターを組み合わせられます。
• read-element：リレーションシップ、includedInViews、deployedInstances、メタデータ、sourceLocation を含む、要素の詳細情報を取得します。
• read-deployment：デプロイメントノードまたはデプロイされたインスタンスの詳細を取得します。
• read-view：ビューの詳細（ノード／エッジ）と sourceLocation を取得します。
• render-view： MCP Apps に対応するホストのチャット内に、インタラクティブな図（パン／ズーム／全体表示）としてビューをレンダリングします。
• preview-view：既存プロジェクトの実際の要素を使い、DSL テキストで定義した LikeC4 ビューのプレビューをディスクに保存せずにレンダリングします。ビューを実際に作成または編集する前の調整に利用できます。
• find-relationships：プロジェクト内の 2 つの要素間にある直接および間接のリレーションシップを取得します。
• query-graph：要素の階層（祖先、子孫、兄弟、子、親）とリレーションシップ（流入、流出）をクエリします。
• query-incomers-graph：上流の依存関係／生成元すべての完全なグラフ（再帰的な流入）を取得します。
• query-outgoers-graph：下流の利用者／依存先すべての完全なグラフ（再帰的な流出）を取得します。
• query-by-metadata：メタデータのキーと値の組み合わせを指定して、要素とデプロイメントノードを検索します。完全一致／部分一致／存在の条件を指定できます。
• query-by-tags：ブール論理（allOf、anyOf、noneOf）を使用して、タグで要素とデプロイメントノードを検索します。
• query-by-tag-pattern：接頭辞、部分一致、または接尾辞によるパターンでタグを指定し、要素を検索します。
• find-relationship-paths：上限付きの BFS 探索を使用して、2 つの要素間のすべてのリレーションシップ経路を見つけます。暗黙のリレーションシップを含めるかどうかは includeIndirect で制御できます。
• batch-read-elements：リンクと sourceLocation を含む複数の要素の概要を、1 回のリクエストで取得します。
• subgraph-summary：要素の子孫を、深さ、メタデータ、リレーションシップ数とともに要約します。
• element-diff：2 つの要素を比較し、プロパティ、タグ、メタデータ、リレーションシップの差異を表示します。
• removal-impact：要素を削除した際に影響を受けるもの（リレーションシップ、デプロイされたインスタンス、ビュー、孤立要素、ソース参照）を報告します。
• list-diffs：モデルの差分（diff ブロック）と、各差分によって変更されるビューを一覧表示します。
• open-view：LikeC4 ビューを開きます（MCP がエディターで実行されている場合に利用できます）。

MCP と LeanIX ブリッジ／Draw.io の違い

MCP ツールは、ワークスペース内の解決済み LikeC4 モデル（検索、グラフクエリ、ビュー）を公開します。@likec4/leanix-bridge のアーティファクトを生成したり、LeanIX の同期を実行したり、leanix プロファイルで Draw.io にエクスポートしたりすることはありません。これらに関する操作には、CLI（likec4 gen leanix …、likec4 sync leanix …、likec4 export drawio --profile leanix）と、このリポジトリの Agent Skill リファレンス bridge-leanix-drawio.md を使用してください。

サポートを受ける

利用を始めるにあたって、いつでも喜んでサポートします。

• Discord コミュニティに参加 — サポートを受ける最も簡単な方法です
• GitHub Discussions — プロジェクトについて質問したり、フィードバックを送ったりできます

コントリビューター

コントリビューターになる

開発を支援する

LikeC4 は MIT ライセンスのオープンソースプロジェクトであり、継続的な開発は皆さまのご支援によって成り立っています。
このプロジェクトを気に入っていただけたら、成長と改善を支えるために、ぜひ金銭的なご支援をご検討ください。
OpenCollective または GitHub Sponsors を通じてご支援いただけます。

ライセンス

このプロジェクトは MIT License の下で公開されています。