Hyperfabric MCP

🚀 Hyperfabric MCP Server

Hyperfabric MCP Server 是一個 MCP（模型上下文協議）服務器，它使大語言模型（LLMs）能夠與 Hyperfabric API 進行交互。該服務器將 79 個 Hyperfabric OpenAPI 端點全部作為工具公開，用於全面的基礎設施管理和自動化。

✨ 主要特性

• 🔧 動態工具生成：自動解析 Hyperfabric OpenAPI 規範並創建 MCP 工具。
• 🛡️ 安全認證：以適當的安全措施處理 Hyperfabric API 令牌認證。
• 📊 完整的 API 覆蓋：公開所有 79 個可用的 Hyperfabric 端點，用於基礎設施管理。
• ✨ 簡潔的工具名稱：工具以直觀的名稱顯示，如 fabricsGetAllFabrics，便於查找。

📦 安裝指南

前提條件

• 安裝 Node.js 18 及以上版本。
• 安裝帶有 GitHub Copilot 的 VSCode 或 Claude Desktop。
• 擁有 Hyperfabric API 憑證（API 令牌）。
• 具備 Hyperfabric OpenAPI 規範文件。

1. 構建服務器

npm install
npm run build

2. 配置大語言模型客戶端

對於帶有 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 個工具）

• Bearer 令牌管理：安全的 API 認證
  • authGetBearerTokens - 列出用戶的所有 bearer 令牌。
  • authCreateBearerTokens - 創建新的 bearer 令牌。
  • authGetBearerToken - 獲取特定 bearer 令牌的詳細信息。
  • authDeleteBearerToken - 刪除特定的 bearer 令牌。
• 用戶管理：用戶賬戶操作
  • authGetUsers - 列出組織中的所有用戶。
  • authGetUser - 獲取特定用戶的詳細信息。
  • authSetUsers - 創建或更新用戶。
  • authUpdateUser - 更新現有用戶。
  • authDeleteUser - 刪除用戶賬戶。

🖥️ 設備管理（3 個工具）

• 設備操作：物理設備管理和綁定
  • devicesGetDevices - 列出所有設備（已綁定和未綁定）。
  • devicesBindDevice - 將設備綁定到 fabric 節點。
  • devicesUnbindDevice - 從 fabric 節點解綁設備。

🏗️ 架構管理（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 個工具）

• 虛擬路由和轉發：三層網絡隔離
  • vrfsGetFabricVrfs - 列出架構中的所有 VRF。
  • vrfsAddFabricVrfs - 創建新的 VRF。
  • vrfsGetFabricVrf - 獲取特定 VRF 的詳細信息。
  • vrfsUpdateFabricVrf - 更新 VRF 配置。
  • vrfsDeleteFabricVrf - 刪除 VRF。
• 靜態路由：VRF 內的靜態路由管理
  • vrfsGetFabricStaticRoutes - 列出 VRF 中的靜態路由。
  • vrfsAddFabricStaticRoutes - 添加靜態路由。
  • vrfsGetFabricStaticRoute - 獲取特定路由的詳細信息。
  • vrfsUpdateFabricStaticRoute - 更新靜態路由。
  • vrfsDeleteFabricStaticRoute - 刪除靜態路由。

📚 詳細文檔

環境變量

開發設置

項目結構

hyperfabric-mcp-server/
├── src/main.ts                                                    # 主服務器實現
├── dist/                                                          # 編譯後的 JavaScript
├── .vscode/                                                       # VS Code 配置
├── package.json                                                   # 依賴項和腳本
├── tsconfig.json                                                  # TypeScript 配置
├── hf_spec_modified.json                                          # 完整的 Nexus Hyperfabric REST API v1.1.0 規範
├── cisco_nexus_hyperfabric_rest_api_1_1_0_rev_2025_10_29_838_c_8.yaml # 原始 YAML 規範文件
└── README.md                                                      # 本文檔

故障排除

常見問題

缺少 API 令牌

# 檢查環境文件
cat .env | grep HYPERFABRIC_API_TOKEN

缺少 OpenAPI 規範

# 驗證規範文件是否存在
ls -la hf_spec_modified.json

編譯錯誤

# 檢查編譯情況
npm run build