Nx Mcp

Nx MCP サーバー

Nx 用の Model Context Protocol サーバー実装です。

概要

Nx MCP サーバーを利用すると、LLM はモノレポの構造（プロジェクト間の関係、ファイルのマッピング、実行可能なタスク、所有権情報、技術スタック、Nx ジェネレーター、さらには Nx のドキュメント）に深くアクセスできます。このコンテキストを活用することで、LLM は技術スタックに合わせたコードを生成し、変更による影響を把握して、関連するファイル間で正確に変更を適用できます。これは、Nx がすでにワークスペースの高レベルなアーキテクチャを把握していること、そしてモノレポでは関連するすべてのプロジェクトが一か所にまとまっていることによって可能になります。

詳しくは、ブログ記事とドキュメントをご覧ください。

インストールと使い方

この MCP サーバーの使い方は 2 通りあります。

a) nx-mcp パッケージを使って実行する

npx または同等のパッケージマネージャーを使って、MCP サーバーを呼び出します。

mcp.json の設定例は次のとおりです。

{
  "servers": {
    "nx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["nx-mcp@latest"]
    }
  }
}

claude mcp add nx-mcp npx nx-mcp@latest

code --add-mcp '{"name":"nx-mcp","command":"npx","args":["nx-mcp"]}'

{
  "nx-mcp": {
    "command": "npx",
    "args": ["nx-mcp@latest"]
  }
}

MCP サーバーの登録方法については、お使いの AI ツールのドキュメントを参照してください。たとえば、Cursor や Claude Desktop は MCP に対応しています。

stdio 経由ではなくサーバーをホストする場合は、--transport http と、必要に応じて --port（デフォルトは 9921）を使用します。クライアントは Streamable HTTP トランスポートを使用して http://localhost:<port>/mcp に接続します。複数の同時接続に対応しているため、異なるクライアントが独立したセッションで同時に接続できます。非推奨の SSE トランスポート（--sse、--transport sse）は削除されました。

利用可能なオプションを確認するには、nx-mcp --help を実行してください。

b) Nx Console 拡張機能を使用する

Cursor をお使いの場合は、Nx Console 拡張機能を直接インストールできます。拡張機能が MCP サーバーを自動的に管理します。

詳細情報：

• Nx Console をインストールする
• nx-mcp を使用するよう Cursor を設定する

最小モード（デフォルト）

デフォルトでは、Nx MCP サーバーは最小モードで実行され、AI ツールのスキルや指示と機能が重複するワークスペース分析ツールは非表示になります。これにより、スキルを通じて同等の機能をすでに利用できる AI エージェントに対して、ツールの煩雑さとコンテキストウィンドウの使用量を削減できます。

最小モードでは、次のツールが非表示になります。

• nx_available_plugins
• nx_workspace_path
• nx_workspace
• nx_project_details
• nx_generators
• nx_generator_schema

最小モードを無効にしてすべてのツールを表示するには、--no-minimal フラグを使用します。

npx nx-mcp@latest --no-minimal

利用可能なツール

Nx MCP サーバーは、Nx ワークスペースを操作するための包括的なツールを提供します。

常に利用可能

• nx_docs：Nx に関するユーザーの質問に関連するドキュメントのセクションを返します
• nx_current_running_tasks_details：現在実行中の Nx TUI プロセスとタスクのステータスを一覧表示します
• nx_current_running_task_output：指定した実行中タスクのターミナル出力を返します
• nx_visualize_graph：Nx グラフを可視化します（IDE インスタンスの実行が必要です）

最小モードでは非表示（有効にするには --no-minimal を使用）

• nx_available_plugins：コアチームおよびローカルワークスペースプラグインから利用可能な Nx プラグインを一覧表示します
• nx_workspace_path：Nx ワークスペースのルートパスを返します
• nx_workspace：プロジェクトグラフと nx.json 設定の読みやすい表現を返します
• nx_project_details：指定したプロジェクトの完全な設定を JSON 形式で返します
• nx_generators：ユーザーのクエリに関連するジェネレーターの一覧を返します
• nx_generator_schema：特定の Nx ジェネレーターの詳細な JSON スキーマを返します

Nx Cloud ツール（Nx Cloud が有効な場合のみ利用可能）

これらのツールでは、Nx Cloud の CI/CD データを確認し、操作できます。

• ci_information：現在のブランチまたは特定の Nx Cloud URL の CI パイプライン実行情報を取得します。runId メタデータを含む失敗したタスクを返し、ページネーション付きのフィールド選択を行う select パラメーターをサポートします。
• ci_task_output：ci_information の runId を使用するか、ブランチ／URL のコンテキストから解決して、特定の失敗した CI タスクのターミナル出力を取得します。
• update_self_healing_fix：Nx Cloud のセルフヒーリング CI 修正を適用、却下、または再実行をリクエストします

ワークスペースパスが指定されていない場合、利用できるのは nx_docs ツールと nx_available_plugins ツールのみです。

利用可能なリソース

Nx Cloud が有効なワークスペースに接続すると、Nx MCP サーバーは最近の CI パイプライン実行（CIPE）を MCP リソースとして自動的に公開します。 リソースは AI ツールのリソースピッカーに表示され、LLM は失敗したタスク、ターミナル出力、影響を受けたファイルなど、CI の実行に関する詳細情報にアクセスできます。

貢献と開発

貢献を歓迎します！詳しくは、Nx Console の貢献ガイドをご覧ください。

基本的な手順は次のとおりです。

1. Nx Console リポジトリをクローンし、インストール手順に従います
2. nx run nx-mcp:build を使用して nx-mcp をビルドします（ソースマップを使ってデバッグする場合は nx run nx-mcp:build:debug）
3. MCP Inspectorを使って変更をテストします

設定ファイル

ワークスペースのルートにある .nx/nx-mcp-config.json の JSON ファイルを使って、MCP サーバーを設定することもできます。これは、MCP サーバーのバイナリがプラグインや拡張機能によって管理されていて、CLI 引数を直接渡せない場合に便利です。

{
  "tools": ["nx_docs", "!cloud_*"],
  "minimal": true,
  "debugLogs": false,
  "disableTelemetry": true,
  "transport": "http",
  "port": 9922
}

すべてのキーは省略可能で、CLI オプション名に対応しています。CLI 引数は設定ファイルの値より優先されます。

ライセンス

MIT