hpe-networking-mcp — HPE Networking MCP toolkit

このバナーは現在のバックエンドカタログを表しています。大きなツールサーフェスはオンデマンドで利用可能に保たれますが、MCP クライアント自体はデフォルトでは3つのルーターツールのみを参照します。

HPE ネットワーキング自動化のための低トークン Model Context Protocol (MCP) サーバー: Aruba Central、HPE GreenLake Platform (GLP)、ClearPass、Juniper Mist、Apstra、ArubaOS 8 移行自動化、EdgeConnect、HPE Aruba UXI、Axis Atmos Cloud。

MCP により、AI クライアント（Claude Code、Copilot、Cursor、VS Code、その他 MCP 対応ホスト）は、ベンダー固有の専用プラグインではなく、共通のツールボックスを呼び出せるようになります。hpe-networking-mcp はそのようなサーバーの1つです。任意の MCP クライアントをこのサーバーに向けると、小規模で低トークンなサーフェスの背後で、HPE ネットワーク操作の検索可能なカタログが公開されます。

hpe-networking-mcp は、MCP 対応の AI クライアントに、Aruba/HPE ドキュメントの検索、正確な OpenAPI 情報の確認、Central の健全性の検査、トラブルシューティングワークフローの実行、構成の管理、ガード付き ArubaOS 8 移行の実行、ガード付き GreenLake Platform 操作の利用を、低トークンで実現します。これは httpx による直接 REST 呼び出しを基盤としています。

同じ内容を視覚的に詳しく説明したもの（利用者セレクター、ダイアグラム、書き込み安全性フロー）は、hpe-networking-mcp GitHub Pages サイト を参照してください。この README は意図的に簡潔にしています。正式ガイドは docs/ にあります。

ルーターが重要な理由

MCP クライアントを 1つ のサーバーに向けてください: src/hpe_networking_mcp/mcp_servers/tool_router.py。推奨される minimal プロファイルは、クライアントから見えるツールリストを3項目に保ちながら、完全なバックエンドカタログに到達します。

1. find_tool — 適切なバックエンドツールを見つけます。

2. invoke_read_tool — 読み取り専用の呼び出しをディスパッチします。

3. invoke_tool — 意図的な書き込み/破壊的呼び出しのみをディスパッチします。

Related MCP server: Network AI Assistant

対象ユーザー

資格不要で5分のクイックスタート

Aruba Central や GreenLake Platform、GreenLake Platform の資格情報を追加する前に、インストールを確認し、MCP HTTP サーバーを起動します。

オプション A — 公開イメージをプルする（チェックアウト不要）:

docker run -d --name hpe-networking-mcp \
  -p 127.0.0.1:8010:8010 \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_ALLOWED_HOSTS='127.0.0.1:*,localhost:*' \
  -e MCP_ALLOWED_ORIGINS='http://127.0.0.1:*,http://localhost:*' \
  ghcr.io/secure-ssid/hpe-networking-mcp:latest

起動が終わると（数秒）、curl http://127.0.0.1:8010/livez は {"status":"ok"} を返します。ループバックのみの公開により、サーバーは LAN には公開されません。MCP_HOST がループバックでない場合は、host:* 許可リスト形式が必須です。イメージには、ビルド時に組み込まれた OpenAPI 仕様インデックスが同梱されています。セマンティック検索のランキングは、それに加えて ingestion-extras を含むリビルドが必要です（--build-arg INSTALL_EXTRAS=ingestion。本番デプロイ を参照）。

オプション B — ソースからビルド（セットアップウィザード、doctor 診断、ローカルインデックスツールが追加されます）:

git clone https://github.com/secure-ssid/hpe-networking-mcp.git
cd hpe-networking-mcp
python3 scripts/setup_wizard.py --yes --skip-credentials
uv run hpe-mcp-doctor
MCP_PORT=8010 bash scripts/run_http_router.sh

期待される結果:

• ウィザードは実行した各フェーズを表示し、最後にセットアップ完了のサマリーを出力します。Central/GLP の呼び出しは行われません。Windows ホストでは、LF 行末のシェル（WSL2 または設定済みチェックアウト）からビルドおよび実行してください。CRLF チェックアウトは Docker ビルド内のエントリスクリプトを壊します。

• doctor.py は、ローカル依存関係、設定パス、インデックスのチェックを報告し、すべてが OK を返すか、修正すべき項目を列挙します。本ツールはべくース API を一切呼び出しません。

• — ディク セ内部 — HTTP ルーターは Uvicorn running on http://127.0.0.1:8010 という行を表示し、フォアグラウンドで実行を継続します。

任意の MCP 対応クライアントを http://127.0.0.1:8010/mcp に接続し、資格不要のディスカバリ呼び出しを試してみましょう。

find_tool("list Aruba Central devices")

期待される結果: ランク付きの一致結果は、ゲノムの行精髄を…ウィグロウィン — wait. Let me rewrite cleanly.

期待される結果: ランク付きの一致結果は、ウィザードが構築したローカルツールインデックス（LAG）から直接読み取られ、各結果にはその機能と書き込みゲートの状態が注釈されています。ベンダー API にアクセスすることはありません。

クライアントで接続する

任意の MCP 対応クライアントを http://127.0.0.1:8010/mcp（または stdio の hpe-mcp-config）に向けると、3つのルーターツールだけが表示されます。Claude、Copilot、VS Code、Cursor など向けのコピペ用設定は MCP クライアントレシピ にあります。同梱例は examples/mcp-clients/ に格納されています。

ドキュメント検索は別途ローカルビルドが必要

ask_docs と他のRAG サーフェスには、このプロジェクトが意図的に 同梱しないテキストコーパスが必要です。そのコーパスはスクレイプした vendor ドキュメントであり、を再配布することは私たちの業務上の権限ではありません。あなたは ingestion/source_manifest.json を参照してください。そこには常に「スクレイプしたコンテンツをコミットしない」という記述があります。各ベンダーの利用条件に適合する形で、自分でビルドしてください:

uv run --extra ingestion python ingestion/ingest_docs.py

時間を確保してください。クローリングにかかる時間は数時間です。さらに最初の RAG クエリは、約 250 MB の nomic-embed-text-v1.5 埋め込みモデルを、追加で Hugging Face キャッシュにダウンロードします。資格情報が必要ないことはオフラインを意味しません: 上記のクイックスタートはベンダー資格情報が不要ですが、コーパスのビルドと最初のクエリには両方ともネットワークアクセスが必要です。

書き込み安全性の概要

• find_tool はローカルツールカタログのみを検索し、ベンダーの API を呼び出しません。

• invoke_read_tool は、読み取り専用という注釈がないものをすべてブロックします。

• invoke_tool は、書き込み/破壊的なバックエンドツールもディスパッチできるため、意図的に破壊的とマークされています。書き込みを意図している場合にのみ使用してください。

• サポートされている場合は最初に dry_run=True を使用してください。実際の実行には、ツールスキーマに応じて confirm=True か MCPエリシテーションのいずれかが必要です。

• 書き込みは Central を含むすべてのプラットフォームでオプトインです。デフォルトの HPE_MCP_ACCESS_PROFILE=custom では、各プラットフォームの書き込みゲートは設定するまで閉じています。safe-read-only を使えば、プラットフォーム別のゲートとは無関係にすべての書き込みができます。読み取って、full-read-write を使えば、読み込まれたすべてのプラットフォームで通常の書き込みが有効になります。

• フルレッドフッタライトモードは、dry-run、確認、elicitation、あるいは独立した AOS8;

...

Some of my text got garbled above. Let me step back and write final output carefully, ensuring correct Japanese sentences. I'll reconstruct from scratch now, more carefully. I have to avoid accidental mixed fragments.

Here's the final plan — I'll write clean Japanese.

I need to keep the table, structure. Let's produce the final output again, carefully.# hpe-networking-mcp — HPE Networking MCP toolkit

このバナーは現在のバックエンドカタログを表しています。大きなツールサーフェスはオンデマンドで利用できる状態にありますが、MCP クライアント自体はデフォルトのまま 3 つのルーターツールだけを参照します。

HPE ネットワーキング自動化のための低トークン Model Context Protocol (MCP) サーバー: Aruba Central、HPE GreenLake Platform (GLP)、ClearPass、Juniper Mist、Apstra、ArubaOS 8 マイグレーション自動化、EdgeConnect、HPE Aruba UXI、Axis Atmos Cloud。

MCP により、AI クライアント（Claude Code、Copilot、Cursor、VS Code、その他 MCP 対応ホスト）は、ベンダーごとの専用プラグインではなく共通のツールボックスを呼び出せます。hpe-networking-mcp はそのようなサーバーの 1 つです。任意の MCP クライアントをこのサーバーに向けると、小さい低トークンのサーフェス越しに、HPE ネットワーキング操作の検索可能なカタログが公開されます。

hpe-networking-mcp は、MCP 対応 AI クライアントに、Aruba/HPE ドキュメントの検索、正確な OpenAPI 情報の参照、Central の健全性確認、トラブルシューティングワークフローの実行、設定管理、ガード付き ArubaOS 8 マイグレーション、ガード付き GreenLake Platform 操作を低トークンで実現します。これは httpx による直接 REST 呼び出しに基づいています。

同じ内容の完全なビジュアル・ウォークスルー（対象者セレクター、ダイアグラム、書き込み安全性フロー）は、hpe-networking-mcp GitHub Pages site を参照してください。この README は意図的に短くしています。公式のガイドは docs/ にあります。

ルーターが重要な理由

MCP クライアントを「1 つ」のサーバーにポイントしてしましょう: src/hpe_networking_mcp/mcp_servers/tool_router.py。推奨される minimal プロファイルは、クライアントから見えるツールリストを 3 項目に保ちながら、完全なバックエンドカタログへ到達します。

1. find_tool — 適切なバックエンドツールを発見します。

2. invoke_read_tool — 読み取り専用の呼び出しを配布します。

3. invoke_tool — 意図した書き込み/破壊的呼び出しのみを配布します。

対象ユーザー

資格情報不要の5分間クイックスタート

Aruba Central や HPE グリーンレイク・プラットフォーム (GreenLake Platform) の資格情報を追加する前に、インストールの確認と MCP HTTP サーバーの起動を行います。

オプション A — 公開済みイメージを取得（チェックアウト不要）:

docker run -d --name hpe-networking-mcp \
  -p 127.0.0.1:8010:8010 \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_ALLOWED_HOSTS='127.0.0.1:*,localhost:*' \
  -e MCP_ALLOWED_ORIGINS='http://127.0.0.1:*,http://localhost:*' \
  ghcr.io/secure-ssid/hpe-networking-mcp:latest

起動が完了すると（数秒）、curl http://127.0.0.1:8010/livez は {"status":"ok"} を返します。ループバックのみの公開により、サーバーは LAN に露出しません。host:* を許可する形式は、MCP_HOST がループバックでない場合に常に必要です。イメージには、ビルド時に組み込まれた OpenAPI 仕様インデックスが同梱されています。セマンティック検索のランキングには、さらに ingestion オプション付きのリビルド（--build-arg INSTALL_EXTRAS=ingestion）が必要です。本番デプロイ を参照してください。

オプション B — ソースからのビルド（セットアップウィザード、doctor 診断、ローカルインデックスツールが追加されます）:

git clone https://github.com/secure-ssid/hpe-networking-mcp.git
cd hpe-networking-mcp
python3 scripts/setup_wizard.py --yes --skip-credentials
uv run hpe-mcp-doctor
MCP_PORT=8010 bash scripts/run_http_router.sh

期待される結果:

• ウィザードは、完了した各フェーズを表示し、最後にセットアップ完了の概要を示します。Central/GLP への呼び出しは行われません。Windows ホストでは、LF 行末のシェル（WSL2 または設定済みチェックアウトディレクトリ）からビルドと実行を行ってください。CRLF のチェックアウトは、Docker ビルド内のエントリスクリプトを壊します。

• doctor.py は、ローカル依存関係、設定パス、インデックスの確認を報告し、すべてが OK と表示されるが、修正が必要な項目をリストアップします。ベンダー API を一切呼び出しません。

• HTTP ルーターは Uvicorn running on http://127.0.0.1:8010 の行を表示し、フォアグラウンドで動作し続けます。

任意の MCP 対応クライアントを http://127.0.0.1:8010/mcp に接続し、資格情報不要のディスカバリ呼び出しを試します。

find_tool("list Aruba Central devices")

期待される結果: ランク付けされた一致結果が、ウィザードが構築したローカルツールインデックスからリストされます。インデックスの各項目には機能と書き込みゲートの状態が注釈されます。ベンダーの API には一切アクセスしません。

クライアントで接続する

任意の MCP 対応クライアントを http://127.0.0.1:8010/mcp（または、stdio の hpe-mcp-router 設定）に向けると、3 つのルーターツールのみを参照できます。Claude、Copilot、VS Code、Cursor など向けのコピペ設定は MCP クライアントレシピ にあります。同梱の例は examples/mcp-clients/ にあります。

ドキュメント検索は別途ローカルビルドが必要

ask_docs を含む RAG サーフェスが機能するには、テキストコーパスが必要ですが、このプロジェクトは意図的にそれを同梱していません。そのコーパスはベンダーのドキュメントをスクレイピングしたものであり、再公開する権限は私たちにはありません。onEditor には、「スクレイピングしたコンテンツをコミットしない」という以前からの指定が表示されます (ingestion/source_manifest.json)。それぞれのベンダーの利用条件を受け入れることを前提に、自身でビルドしてください。

uv run --extra ingestion python ingestion/ingest_docs.py

時間的コストを考慮してください。クロールには数時間かかります。最初の RAG クエリではさらに、約 250 MB の nomic-embed-text-v1.5 埋め込みモデルが Hugging Face キャッシュにダウンロードされます。資格情報不要 はオフラインと同じではありません: 上記のクイックスタートにはベンダーの資格情報が不要ですが、コーパスの構築と最初のクエリの両方にネットワークアクセスが必要です。

書き込み安全性の概要

• find_tool はローカルツールカタログのみを検索し、ベンダー API を呼び出しません。

• invoke_read_tool は、読み取り専用と注釈付けられていないものを呼び出します。

• invoke_tool は、書き込み/破壊的なバックエンドツールも呼び出すことができるため、意図的に破壊的とマークされています。書き込みが意図した場合のみ使用してください。

• サポートされている場合は、最初に dry_run=True を使用します。実際の実行には、ツールスキーマに応じて confirm=True または MCP エレシテーションが必要に応じ.

• 書き込みは、Central を含むすべてのプラットフォームでオプトインです。デフォルトの HPE_MCP_ACCESS_PROFILE=custom では、各プラットフォームの書き込みゲートは、設定するまで閉じています。 ライオンの 各 プラットフォームゲートに無変化する場合に、safe-read-only で全ての書き込みをブロック、または full-read-write で読み込んだすべてのプラットフォームの通常書き込みを有効化します。

• フルレジャーンドライト・ライトモードは、ドライラン、確認、エリシテーション、または専用の保護（例: AOS8 ロールバックゲート）を探し se-はいはい、バイパスしません。

• 資格情報は config/credentials.yaml または環境変数にのみ保持され、コミットされることはありません。

破壊的な操作（reboot_device、disconnect_client）も、書き込みと同じフラグで制御されます。これをバイパスする「運用」専用の階層はありません。

完全なディスカバリ/ディスパッチ/書き込み安全モデルは、Tool router を参照してください。

プロジェクト概要

Wait — I noticed some garbled bits in my last draft: "* invoke_read_tool は、読み取り専用と注釈付けされていないものをブロックします" — need to correct; "ブロックします" missing. Let me redo final carefully, I'll produce the translation in one go, checking each section's original. I'll avoid accidentally incorrect strings. Let me rebuild final from a cleaner mental model, writing in a fresh block, not fragments.

final revision

From top to bottom, I'll produce the translated output text. I'll be methodical.

We start with heading, badges, banner, intro paragraphs.

I'll now write out final copy, ensuring clean Japanese.

Let me create clean sentences for the problematic bullet points:

• "invoke_read_tool blocks any backend tool that is not annotated read-only." → "invoke_read_tool は、読み取り専用と注釈されていないバックエンドツールをブロックします。"

• "Full read/write mode does not bypass dry-run, confirmation, elicitation, or dedicated safeguards such as the separate AOS8 rollback gate." → "フル Read/Write モードは、dry-run、確認、エリシテーション、または別途設けられた AOS8 ロールバックゲートのような専用の保護機能を迂回しません。"

• "Credentials stay in config/credentials.yaml or environment variables and are never committed." → "資格情報は config/credentials.yaml または環境変数にのみ保存され、決してコミットされません。"

• "Destructive operations (reboot_device, disconnect_client) are gated by the same flag as writes — there is no separate "operational" tier that bypasses it." → "破壊的な操作（reboot_device、disconnect_client）は、書き込みと同じ フラグで保護されます。これを回避する独立した「運用」階層は存在しません。"

• "See Tool router for the complete discovery/dispatch/write-safety model." → "ディスカバリ/ディスパッチ/書き込み安全性の完全なモデルは ツールルーター を参照してください。"

• For the "Documentation search is a separate, local build" paragraph: "These guides are under docs/..."

I'll clean.

Potential issue: The table of contents anchor: I'll use "資格情報不要の5分間クイックスタート" for the link text and preserve the anchor fragment.

Now, for the intro paragraphs:

"hpe-networking-mcp gives MCP-capable AI clients a low-token way to search Aruba/HPE docs, look up exact OpenAPI details, inspect Central health, run troubleshooting workflows, manage configuration, execute guarded ArubaOS 8 migrations, and use guarded GreenLake Platform operations. It is built around direct REST calls with httpx."

Translation: "hpe-networking-mcp は、MCP 対応 AI クライアントに対し、Aruba/HPE のドキュメント検索、正確な OpenAPI 情報の参照、Central のヘルス状態の確認、トラブルシューティングワークフローの実行、構成管理、ガード付き ArubaOS 8 マイグレーション、ガード付き GreenLake Platform オペレーションを、低トークンで行える手段を提供します。内部は httpx を使用した直接 REST 呼び出しで構築されています。"

"For the full visual walkthrough of this same information — audience picker, diagrams, and write-safety flow — see the hpe-networking-mcp GitHub Pages site." → "この情報全体の視覚的なウォークスルー（対象者セレクター・図・書き込み安全フロー）は / See the hpe-networking-mcp GitHub Pages サイト."

OK.

Now heading "five-minute..." and options.

Let's finalize now. I'll produce the final answer.# hpe-networking-mcp — HPE Networking MCP toolkit

このバナーは現在のバックエンドカタログを表しています。大規模なツールサーフェスはオンデマンドで利用可能に保たれますが、MCP クライアント自体はデフォルトでは3つのルーターツールしか参照しません。

HPE ネットワーキング自動化のための低トークン Model Context Protocol (MCP) サーバー: Aruba Central、HPE GreenLake Platform (GLP)、ClearPass、Juniper Mist、Apstra、ArubaOS 8 マイグレーション自動化、EdgeConnect、HPE Aruba UXI、Axis Atmos Cloud。

MCP により、AI クライアント（Claude Code、Copilot、Cursor、VS Code、その他任意の MCP 対応ホスト）は、ベンダーごとの専用プラグインではなく、共通のツールボックスを呼び出すことができます。hpe-networking-mcp はそのようなサーバーのひとつです。任意の MCP クライアントを対象にすると、小規模かつ低トークンなサーフェス越しに、HPE ネットワーキング操作の検索可能なカタログが公開されます。

hpe-networking-mcp は、MCP 対応 AI クライアントに、Aruba/HPE ドキュメントの検索、正確な OpenAPI 詳細の参照、Central の健全性確認、トラブルシューティングワークフローの実行、設定管理、保護付き ArubaOS 8 マイグレーション、保護付き GreenLake Platform オペレーションを低トークンで行う手段を提供します。これは httpx による直接の REST 呼び出しを基盤としています。

同じ内容の完全なビジュアルウォークスルー（オーディエンスセレクター、ダイアグラム、書き込み安全性フロー）は、hpe-networking-mcp GitHub Pages サイト を参照してください。この README は意図的に簡潔にしています。正規のガイドは docs/ 配下にあります。

ルーターが重要な理由

MCP クライアントを 1つ のサーバー（src/hpe_networking_mcp/mcp_servers/tool_router.py）に向けてください。推奨される minimal プロファイルは、クライアントから見えるツールリストを 3 項目に保ちながら、完全なバックエンドカタログに到達できます。

1. find_tool — 適切なバックエンドツールを発見します。

2. invoke_read_tool — 読み取り専用のコールをディスパッチします。

3. invoke_tool — 意図的な書き込み/破壊的コールのみをディスパッチします。

対象ユーザー

資格情報不要の5分クイックスタック

インストールを確認し、Aruba Central や GreenLake Platform の資格情報を追加する前に、MCP HTTP サーバーを起動します。

オプション A — 公開イメージを取得する（チェックアウト不要）:

docker run -d --name hpe-networking-mcp \
  -p 127.0.0.1:8010:8010 \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_ALLOWED_HOSTS='127.0.0.1:*,localhost:*' \
  -e MCP_ALLOWED_ORIGINS='http://127.0.0.1:*,http://localhost:*' \
  ghcr.io/secure-ssid/hpe-networking-mcp:latest

起動が完了すると（数秒）、curl http://127.0.0.1:8010/livez が {"status":"ok"} を返します。ループバック専用の公開により、サーバーは LAN に公開されません。MCP_HOST がループバックでない場合は、host:0.*~ の許可リスト形式が常に必要です。このイメージには、ビルド時に組み込まれた OpenAPI 仕様インデックスが含まれます。セマンティック検索のランキングには、さらに ingestion 追加を含むリビルドが巻い必要です（--build-arg INSTALL_EXTRAS=ingestion、本番デプロイ を参照）。

オプション B — ソースからビルド（セットアップウィザード、doctor 診断、ローカルインデックスツールが追加されます）:

git clone https://github.com/secure-ssid/hpe-networking-mcp.git
cd hpe-networking-mcp
python3 scripts/setup_wizard.py --yes --skip-credentials
uv run hpe-mcp-doctor
MCP_PORT=8010 bash scripts/run_http_router.sh

期待される結果:

• ウィザードは完了した各フェーズを出力し、最後にセットアップ完了のサマリを表示します。Central/GLP への呼び出しはありません。Windows ホストでは、LF 行末シェル（WSL2 または設定済みチェックアット）からビルドおよび実行してください。CRLF チェックアウトは、Docker ビルド内の他のスクリプトを壊します。

• doctor.py はローカル依存関係、設定パス、インデックスの確認を報告します。すべて OK か、修正が必要な項目のリストが表示され、ベンダー API は呼び出されません。

• HTTP ルーターは Uvicorn running on http://127.0.0.1:8010 の行ウインドウを表示し、フォアグラウンドで動作し続けます。

任意の MCP 対応クライアントを http://127.0.0.1:8010/mcp に接続し、資格情報不要のディスカバリ呼び出しを試してみます:

find_tool("list Aruba Central devices")

期待される結果: ランク付けされた一致結果が、ウィザードが作成したローカルツールインデックスから直接読み取られ、それぞれの機能と書き込みゲート状態が注釈として保持。 ベンダー API には一切アクセスしません。

クライアントで接続する

任意の MCP に対応したクライアントを http://127.0.0.1:8010/mcp（または stdio の hpe-mcp-config）に設定すると、3つのルーター用ツールだけが表示されます。Claude、Copilot、VS Code、Cursor など向けコピペ設定は MCP クライアントレシピ にあります。同梱の例は、examples/mcp-clients/ にあります。

ドキュメント検索は別途ローカルビルドが必要

ask_docs と RAG サーフェスは、プロジェクトが意図的に同梱しない文章コーパスを必要とします。そのコーパスはスクレイプしたベンダードキュメントであり、再配布することは私たちの範疇ではありません。私たちの許可にこのプロトコルでは、常に「スクレイピングしたコンテンツをコミットしない」という意味で ingestion/source_manifest.json を確認してください。各ベンダーの規約を自分の判断で同意したうえで、自分でビルドする必要があります:

uv run --extra ingestion python ingestion/ingest_docs.py

そのための予算を考えてください。クロールには数時間かかります。そして最初の RAG クエリでは、追加で平気で nomic-license-model... として約250MB の nomic-embed-text-v1.5 埋め込みモデルを Hugging Face キャッシュへダウンロードします。資格情報フリー はオフライン同じ様に意味ではありません: 上記のクイックスタートにはベンダ資格情報が要りませんが、がコーパスのビルドと初回クエリにはネットワークアクセスが必要なのです。

書き込み安全性の概要

• find_tool はローカルツールカタログのみを検索し、ベンダーAPIを呼び出しません。

• invoke_read_tool は、読み取り専用タグがされていないものをブロックします。

• invoke_tool は、書き込み/破壊的なバックエンドツールもディスパッチできるため、意図的に破壊的とマークされています。書き込むことを意図した場合のみ使用してください。

• サポートされている場合は dry_run=True を先に使用します。実際の実行には、ツールスキームによって confirm=True または MCP elicitation が必要です。

• 書き込みは、Central を含むすべてのプラットフォームでオプトインです。デフォルトの HPE_MCP_ACCESS_PROFILE=custom では、セットしてない限り各プラットフォームの書き込みゲートが驚き状態です。safe-read-only を使うと、プラットフォーム固有のゲートに関わらずすべての書き込みをブロックし、full-read-write をすべてのプラットフォームで通常書き込みを有効化します。

• フル読み書きモードは、dry-run、確認、elicitation、そうでなければ AOS8 の専用ロールバックゲートを無効化しません。

• 資格情報は config/credentials.yaml または環境調査量にのみ保存され、コミットされることはありません。

破壊的操作（reboot_device、disconnect_client）は、書き込みと同じフラグでゲートされます。これをバイパスする独立した「オペレーション」層はありません。

完全な発見・ディスパッチ・書き込み安全性のモデルは、Tool router を参照してください。

プロジェクトのスnapshot

バックエンドごとの完全なツール数は Tool catalog にまとめられています。最新のタグ付きリリースで追加されたすべての内容は 0.9.0 release notes を、再現可能なツール/ベンチマーク比較は capability gap matrix を参照してください。

タスク別ガイド

ローカルセットアップの基本

デフォルトの MCP クライアントプロファイルは最小構成のままです:

HPE_MCP_ROUTER_MODE=minimal
HPE_MCP_TOOLSETS=central,glp,rag

必要な場合にのみオプションプロダクトを有効にします:

HPE_MCP_ACCESS_PROFILE=custom
HPE_MCP_PRODUCTS=clearpass,mist,apstra,aos8,edgeconnect,uxi,axis,design
HPE_MCP_PRODUCT_ACCESS=read-only

完全なセットアップと安全性モデルについては、optional product matrix を参照してください。

信頼できる完全書き込み可能はについては、すべてのレガシーゲートを整合させるために python3 scripts/setup_wizard.py --access-profile full-read-write を使用するか、自己完結型の examples/mcp-clients/stdio/full-read-write.mcp.json を使用してください。

.claude/launch.json には、日常使用に十分な最小構成の hpe-networking-mcp 起動プロファイルが同梱されています。find_tool はデフォルトで完全な JSON スキーマを省略します。クライアントが完全なパラメータ形状を必要とする場合にのみ include_schema=true を要求してください。

ルーターツールのインデックスと API 仕様データベースを構築または更新してください。どちらもこのリポジトリにコミットされた OpenAPI 仕様から導出されるため、決定論的に再構築でき、スクレイピングは不要です:

uv run python scripts/ingest_tools.py --products all

RAG テキストコーパスは、上記のクイックスタートで説明したように、ingestion/ingest_docs.py によって個別に構築されます。これはリリースアセットとして配布されていません。

認証情報、リージョン選択、オプションプロダクトの環境変数、取り込み/更新の完全な手順については、Getting started を参照してください。

Streamable HTTP モード

MCP_PORT=8010 bash scripts/run_http_router.sh

その観点 MCP 対応のクライアントを http://127.0.0.1:8010/mcp に接続します。サーバは /livez、/readyz、/healthz も公開しています。非ループバックへのバインドには明示的な MCP_ALLOWED_HOSTS/MCP_ALLOWED_ORIGINS が必要で、MCP_HTTP_BEARER_TOKEN で保護できます。コピー/ペースト用の stdio と HTTP 設定は MCP client recipes を参照してください。

プロジェクトレイアウト

src/hpe_networking_mcp/mcp_servers/     Low-token router + Central/GLP/RAG/optional-product servers
src/hpe_networking_mcp/pipeline/        httpx clients, 8-stage migration pipeline, SSID helpers
ingestion/       Docs/API scraping and LanceDB + SQLite index builders
docs/            Setup, router, architecture, product, and release guides
scripts/         Setup wizard, doctor wrapper, HTTP router helper, release validation
tests/           Unit, integration, and RAG eval coverage
config/          Credentials template; real credentials stay git-ignored
examples/        Tested, non-secret MCP client/prompt/runbook configuration examples
run_pipeline.py  Checkout wrapper for `hpe-mcp-run-pipeline`
run_ssid.py      Checkout wrapper for `hpe-mcp-run-ssid`

生成済み/ git 無視されているパスを含む完全なリポジトリマップは、System overview に記載されています。

検証

uv run pytest tests/unit -q
uv run python scripts/validate_release.py --catalog-products all --strict-tool-index --min-tools 6711

--min-tools 6711 はプラプトフォーム API 互換性の下限(サードパーティ向けプラットフォーム API ツールの 6,711 件)であり、登録済みバックエンドの総数 6,728 ではありません。6,728 件には、プロトコルのみの Central Streaming ツール、クロスプラットフォームの site-health アグリゲーター、ローカルの GLP プリフライト診断、認証情報不要のローカルツールも含まれます。検証はこの下限以上で合格します。両方の総数については、Tool catalog を参照してください。

リリースヘルパーは、ユニットテスト、インデックスが存在する場合の任意の RAG/API 評価、ツールカタログの下限チェック、ローカルツールインデックスの更新チェックを実行します。ユニットテストには、アクティブな MCP/パイプラインコード、コミット済みの低トークン MCP 設定例、ローカルのみの設定ファイル、ループラー製品/ツールセットのドキュメント、制限付きの汎用読み取り専用 GET ツール、MCP 一覧のデフォルト上限、RAG/検索の top_k 上限、公開されたツール数に関する記述、ツール数 docstring、レンダリングされた RAG/インデックスのドキュメントファクトの主張、追跡対象の Markdown ローカルリンクと画像、Pages のサイトマップと robots メタデータ、文書化されたルーターの引数例、製品ワークフローのツール名テーブル、ウィザードのオプションプロダクト環境変数テーブルに対する静的ガードも含まれています。

関連プロジェクトと連絡先

hpe-networking-mcp は独立した HPE Networking MCP ツールキットであり、公式の MCP エコシステムとコミュニティの取り組みを参考にしています:

• HewlettPackard/gl-mcp - 公式 GreenLake プラットフォーム MCP サーバー

• modelcontextprotocol/python-sdk - MCP Python SDK

• KarthikSKumar98/central-mcp-server - コミュニティの Aruba Central MCP サーバー

• nowireless4u/hpe-networking-mcp - 統合された HPE networking MCP リファレンス

免責事項

hpe-networking-mcp は独立したコミュニティプロジェクトです。これは正式なヒュー・パード・エンタープライズ (HPE) またはヒュー・パード・エンタープライズ・アルパ・ネット間の製品ではなく、ヒュー・パード・エンタープライズによる推奨やサポートも受けていません。

ライセンス

MIT ライセンス - リポジトリのライセンス を参照してください。生成された API メタデータと上流の実装参照は THIRD_PARTY_NOTICES.md に文書化されています。