Cisco Hyperfabric Mcp

Hyperfabric MCP サーバー

LLM が Hyperfabric API とやり取りできるようにする MCP（Model Context Protocol）サーバーです。このサーバーは、包括的なインフラストラクチャ管理と自動化のために、Hyperfabric の OpenAPI エンドポイント 79 個すべてをツールとして公開します。

🔧 動的なツール生成：Hyperfabric OpenAPI 仕様を自動的に解析し、MCP ツールを作成します
🛡️ セキュアな認証：適切なセキュリティ対策のもと、Hyperfabric API トークン認証を処理します
📊 完全な API カバレッジ：インフラストラクチャ管理のため、利用可能な Hyperfabric エンドポイント 79 個すべてを公開します
✨ わかりやすいツール名：ツールは、簡単に見つけられるように fabricsGetAllFabrics のような直感的な名前で表示されます

前提条件

• Node.js 18+ がインストールされていること
• GitHub Copilot または Claude Desktop を備えた VSCode
• Hyperfabric API 認証情報（API Token）
• Hyperfabric OpenAPI 仕様ファイル

1. サーバーをビルドする

npm install
npm run build

2. LLM クライアントを設定する

GitHub Copilot を使用する VSCode の場合

1. VSCode の設定を開きます：Cmd+Shift+P → 「Preferences: Open User Settings (JSON)」

2. この設定を settings.json に追加します：

{
  "github.copilot.chat.mcp.servers": {
    "hyperfabric": {
      "command": "node",
      "args": ["/path/to/hyperfabric-mcp-server/dist/main.js"],
      "env": {
        "HYPERFABRIC_API_TOKEN": "your-api-token",
        "LOG_LEVEL": "info"
      }
    }
  }
}

3. VS Code を再読み込みします：Cmd+Shift+P → 「Developer: Reload Window」

Claude Desktop の場合

1. Claude Desktop の設定ファイルを探します：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
   • Linux： ~/.config/Claude/claude_desktop_config.json

2. この設定を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "hyperfabric": {
      "command": "node",
      "args": ["/path/to/hyperfabric-mcp-server/dist/main.js"],
      "env": {
        "HYPERFABRIC_API_TOKEN": "your-api-token",
        "LOG_LEVEL": "info"
      }
    }
  }
}

3. Claude Desktop アプリケーションを再起動します

利用可能なツールと機能

MCP サーバーは、Nexus Hyperfabric REST API v1.1.0 の完全な仕様から79 個のツールを自動的に生成します。

� 認証とユーザー管理（9 個のツール）

• ベアラートークン管理：安全な API 認証

  • authGetBearerTokens - ユーザーのすべてのベアラートークンを一覧表示
  • authCreateBearerTokens - 新しいベアラートークンを作成
  • authGetBearerToken - 特定のベアラートークンの詳細を取得
  • authDeleteBearerToken - 特定のベアラートークンを削除

• ユーザー管理：ユーザーアカウントの操作

  • authGetUsers - 組織内のすべてのユーザーを一覧表示
  • authGetUser - 特定のユーザーの詳細を取得
  • authSetUsers - ユーザーを作成または更新
  • authUpdateUser - 既存のユーザーを更新
  • authDeleteUser - ユーザーアカウントを削除

🖥️ デバイス管理（3 個のツール）

• デバイス操作：物理デバイスの管理とバインド
  • devicesGetDevices - バインド済みおよび未バインドのすべてのデバイスを一覧表示
  • devicesBindDevice - デバイスをファブリックノードにバインド
  • devicesUnbindDevice - デバイスをファブリックノードからバインド解除

🏗️ ファブリック管理（16 個のツール）

• ファブリック構成：ファブリックの主要な操作

  • fabricsGetAllFabrics - 組織内のすべてのファブリックを一覧表示
  • fabricsAddFabrics - 新しいファブリックを作成
  • fabricsGetFabric - 特定のファブリックの詳細を取得
  • fabricsUpdateFabric - ファブリックの構成を更新
  • fabricsDeleteFabric - ファブリックを削除

• 接続管理：ファブリックのネットワーク接続

  • fabricsGetFabricConnections - ファブリック内のすべての接続を一覧表示
  • fabricsAddFabricConnections - 新しい接続を追加
  • fabricsGetFabricConnection - 特定の接続の詳細を取得
  • fabricsSetFabricConnections - すべての接続を置き換え
  • fabricsDeleteFabricConnections - すべての接続を削除
  • fabricsDeleteFabricConnection - 特定の接続を削除

• 構成管理：候補構成とデプロイ

  • fabricsGetFabricCandidates - 候補構成を一覧表示
  • fabricsGetFabricCandidate - 特定の候補構成を取得
  • fabricsCommitFabricCandidate - 候補構成を実行中の構成にデプロイ
  • fabricsRevertFabricCandidate - 候補構成を破棄
  • fabricsReviewFabricCandidate - 候補構成にコメントを追加

🌐 ネットワーク設定（3 個のツール）

• スパニングツリープロトコル：グローバルな STP 設定
  • networksGetFabricStp - ファブリックの STP 設定を取得
  • networksUpdateFabricStp - STP 設定を更新
  • networksResetFabricStp - STP をデフォルトにリセット

� ノード管理（25 個のツール）

• ノード操作：ファブリックのノード設定

  • nodesGetFabricNodes - ファブリック内のすべてのノードを一覧表示
  • nodesAddFabricNodes - ファブリックに新しいノードを追加
  • nodesGetNamedFabricNode - 特定のノードの詳細を取得
  • nodesUpdateFabricNode - ノード設定を更新
  • nodesDeleteFabricNode - ファブリックからノードを削除

• ポート管理：ノードのポート設定

  • nodesGetPorts - ノードのすべてのポートを一覧表示
  • nodesGetPort - 特定のポートの詳細を取得
  • nodesUpdatePort - ポート設定を更新
  • nodesSetPorts - すべてのポート設定を置き換え
  • nodesResetPort - ポートをデフォルトにリセット

• 管理ポート：帯域外管理インターフェース

  • nodesGetManagementPorts - 管理ポートを一覧表示
  • nodesAddManagementPorts - 管理ポートを追加
  • nodesGetManagementPort - 特定の管理ポートを取得
  • nodesUpdateManagementPort - 管理ポートの設定を更新

• ループバックインターフェース：ルーティング用の仮想インターフェース

  • nodesGetNodeLoopbacks - ループバックインターフェースを一覧表示
  • nodesAddNodeLoopbacks - ループバックインターフェースを作成
  • nodesGetNodeLoopback - 特定のループバックの詳細を取得
  • nodesUpdateNodeLoopback - ループバック設定を更新
  • nodesDeleteNodeLoopback - ループバックインターフェースを削除

• サブインターフェース：VLAN とサブインターフェースの設定

  • nodesGetNodeSubInterfaces - サブインターフェースを一覧表示
  • nodesAddNodeSubInterfaces - サブインターフェースを作成
  • nodesGetNodeSubInterface - 特定のサブインターフェースを取得
  • nodesUpdateNodeSubInterface - サブインターフェースの設定を更新
  • nodesDeleteNodeSubInterface - サブインターフェースを削除

� ポートチャネル管理（5 個のツール）

• リンクアグリゲーション：ポートチャネル操作
  • portchannelsGetAllPortChannels - すべてのポートチャネルを一覧表示
  • portchannelsAddPortChannels - ポートチャネルを作成
  • portchannelsGetPortChannel - 特定のポートチャネルを取得
  • portchannelsUpdatePortChannel - ポートチャネルの設定を更新
  • portchannelsDeletePortChannel - ポートチャネルを削除

🏷️ VNI 管理（9 個のツール）

• 仮想ネットワーク識別子：VXLAN ネットワークのセグメンテーション

  • vnisGetFabricVnis - ファブリック内のすべての VNI を一覧表示
  • vnisAddFabricVnis - 新しい VNI を作成
  • vnisGetFabricVni - 特定の VNI の詳細を取得
  • vnisUpdateFabricVni - VNI 設定を更新
  • vnisDeleteFabricVni - VNI を削除

• VNI メンバーシップ：メンバーインターフェースの管理

  • vnisGetFabricVniMembers - VNI メンバーを一覧表示
  • vnisAddFabricVniMembers - VNI にメンバーを追加
  • vnisGetFabricVniMember - 特定のメンバーの詳細を取得
  • vnisDeleteFabricVniMember - VNI からメンバーを削除

�️ VRF 管理（9 個のツール）

• 仮想ルーティングと転送：レイヤー 3 ネットワークの分離

  • vrfsGetFabricVrfs - ファブリック内のすべての VRF を一覧表示
  • vrfsAddFabricVrfs - 新しい VRF を作成
  • vrfsGetFabricVrf - 特定の VRF の詳細を取得
  • vrfsUpdateFabricVrf - VRF 設定を更新
  • vrfsDeleteFabricVrf - VRF を削除

• 静的ルーティング：VRF 内の静的ルート管理

  • vrfsGetFabricStaticRoutes - VRF 内の静的ルートを一覧表示
  • vrfsAddFabricStaticRoutes - 静的ルートを追加
  • vrfsGetFabricStaticRoute - 特定のルートの詳細を取得
  • vrfsUpdateFabricStaticRoute - 静的ルートを更新
  • vrfsDeleteFabricStaticRoute - 静的ルートを削除

環境変数

変数	説明	デフォルト	必須
HYPERFABRIC_API_TOKEN	Hyperfabric API トークン	-	✅
LOG_LEVEL	ログレベル（debug、info、warn、error）	info	❌
OPENAPI_SPEC_PATH	OpenAPI 仕様ファイルのパス	hf_spec_modified.json	❌

開発環境のセットアップ

プロジェクト構成

hyperfabric-mcp-server/
├── src/main.ts                                                    # Main server implementation
├── dist/                                                          # Compiled JavaScript
├── .vscode/                                                       # VS Code configuration
├── package.json                                                   # Dependencies & scripts
├── tsconfig.json                                                  # TypeScript config
├── hf_spec_modified.json                                          # Complete Nexus Hyperfabric REST API v1.1.0 spec
├── cisco_nexus_hyperfabric_rest_api_1_1_0_rev_2025_10_29_838_c_8.yaml # Original YAML spec file
└── README.md                                                      # This documentation

トラブルシューティング

Common Issues

Missing API Token

# Check environment file
cat .env | grep HYPERFABRIC_API_TOKEN

Missing OpenAPI Spec

# Verify spec file exists
ls -la hf_spec_modified.json

Compilation Errors

# Check compilation
npm run build