Nx MCP サーバー

npmバージョン

概要

Nx MCPサーバーは、LLMにモノレポの構造への詳細なアクセスを提供します。プロジェクトの関係性、ファイルのマッピング、実行可能なタスク、オーナーシップ情報、技術スタック、Nxジェネレータ、さらにはNxドキュメントまで、あらゆる情報にアクセスできます。このコンテキストに基づき、LLMはスタックに合わせてコードを生成し、変更の影響を理解し、接続されたファイル全体に変更を正確に適用できます。これは、Nxがワークスペースの高レベルアーキテクチャを既に理解しており、モノレポが関連するすべてのプロジェクトを1か所にまとめているためです。

詳細については、ブログ投稿とドキュメントをご覧ください。

Related MCP server: nile-mcp

インストールと使用方法

この MCP サーバーを使用するには、次の 2 つの方法があります。

a) nx-mcp パッケージ経由で実行する

npxまたはパッケージマネージャーの同等の手段を使用して MCP サーバーを呼び出すだけです。

mcp.json構成の例を次に示します。

{ "servers": { "nx-mcp": { "type": "stdio", "command": "npx", "args": ["nx-mcp@latest", "/path/to/your/workspace"] } } }

VSCode の場合は以下も実行できます:

code --add-mcp '{"name":"nx-mcp","command":"npx","args":["nx-mcp", "/path/to/your/workspace"]}'

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

stdio経由ではなくサーバーをホストしたい場合は、 --sseおよび--portフラグを使用できます。Nx MCP サーバーは現在、単一の同時接続のみをサポートしているため、複数のクライアントに同時に接続すると、場合によっては問題が発生する可能性があります。

利用可能なオプションを確認するにはnx-mcp --helpを実行します。

b) Nxコンソール拡張機能を使用する

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

詳細情報:

利用可能なツール

現在、Nx MCP サーバーはツールセットを提供しています。リソース、ルート、プロンプトはまだサポートされていません。

nx_workspace : ローカルのnx構成とプロジェクトグラフの注釈付き表現を返します。
nx_project_details : 特定のnxプロジェクトの完全なプロジェクト構成を返します
nx_docs : ユーザークエリに関連するドキュメントセクションを取得します
nx_generators : ワークスペースで利用可能なジェネレータのリストを返します。
nx_generator_schema : 特定のジェネレータの詳細なスキーマ情報を提供します
nx_available_plugins : npmレジストリから利用可能なNxプラグインのリストとその説明を返します。

ワークスペースパスが指定されていない場合は、 nx_docsおよびnx_available_pluginsツールのみが使用可能になります。

貢献と開発

貢献を歓迎します! 詳細については、 Nx Console 貢献ガイドをご覧ください。

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

Nxコンソールリポジトリをクローンし、インストール手順に従います。
nx run nx nx-mcp``nx run nx-mcp:buildをビルドします (または、ソースマップを使用してデバッグする場合はnx run nx-mcp:build:debug )。
MCPインスペクタを使用して変更をテストします