Cisco Hyperfabric Mcp

Hyperfabric MCP 服务

一个用于让大模型与 Hyperfabric API 交互的 MCP（Model Context Protocol）服务。此服务将所有 79 个 Hyperfabric OpenAPI 端点作为工具公开，可用于全面的基础设施管理和自动化。

🔧 动态工具生成：自动解析 Hyperfabric OpenAPI 规范并创建 MCP 工具
🛡️ 安全身份验证：安全地处理 Hyperfabric API 令牌身份验证
📊 完整的 API 覆盖范围：公开所有 79 个可用的 Hyperfabric 端点，用于基础设施管理
✨ 清晰易懂的工具名称：工具使用 fabricsGetAllFabrics 等直观名称，便于查找

先决条件

• 已安装 Node.js 18+
• 配备 GitHub Copilot 或 Claude Desktop 的 VSCode
• Hyperfabric API 凭据（API Token）
• 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 Token 管理：安全的 API 身份验证

  • authGetBearerTokens - 列出用户的所有 Bearer Token
  • authCreateBearerTokens - 创建新的 Bearer Token
  • authGetBearerToken - 获取特定 Bearer Token 的详细信息
  • authDeleteBearerToken - 删除特定 Bearer Token

• 用户管理：用户账户操作

  • authGetUsers - 列出组织中的所有用户
  • authGetUser - 获取特定用户的详细信息
  • authSetUsers - 创建或更新用户
  • authUpdateUser - 更新现有用户
  • authDeleteUser - 删除用户账户

🖥️ 设备管理（3 个工具）

• 设备操作：物理设备管理与绑定
  • devicesGetDevices - 列出所有设备（已绑定和未绑定）
  • devicesBindDevice - 将设备绑定到 fabric 节点
  • devicesUnbindDevice - 从 fabric 节点解绑设备

🏗️ Fabric 管理（16 个工具）

• Fabric 配置：核心 fabric 操作

  • fabricsGetAllFabrics - 列出组织中的所有 fabric
  • fabricsAddFabrics - 创建新的 fabric
  • fabricsGetFabric - 获取特定 fabric 的详细信息
  • fabricsUpdateFabric - 更新 fabric 配置
  • fabricsDeleteFabric - 删除 fabric

• 连接管理：Fabric 网络连接

  • fabricsGetFabricConnections - 列出 fabric 中的所有连接
  • fabricsAddFabricConnections - 添加新连接
  • fabricsGetFabricConnection - 获取特定连接的详细信息
  • fabricsSetFabricConnections - 替换所有连接
  • fabricsDeleteFabricConnections - 删除所有连接
  • fabricsDeleteFabricConnection - 删除特定连接

• 配置管理：候选配置与部署

  • fabricsGetFabricCandidates - 列出候选配置
  • fabricsGetFabricCandidate - 获取特定候选配置
  • fabricsCommitFabricCandidate - 将候选配置部署为运行配置
  • fabricsRevertFabricCandidate - 放弃候选配置
  • fabricsReviewFabricCandidate - 为候选配置添加评论

🌐 网络配置（3 个工具）

• 生成树协议：全局 STP 设置
  • networksGetFabricStp - 获取 Fabric STP 配置
  • networksUpdateFabricStp - 更新 STP 设置
  • networksResetFabricStp - 将 STP 重置为默认值

� 节点管理（25 个工具）

• 节点操作：Fabric 节点配置

  • nodesGetFabricNodes - 列出 Fabric 中的所有节点
  • nodesAddFabricNodes - 向 Fabric 添加新节点
  • nodesGetNamedFabricNode - 获取指定节点的详细信息
  • nodesUpdateFabricNode - 更新节点配置
  • nodesDeleteFabricNode - 从 Fabric 中移除节点

• 端口管理：节点端口配置

  • 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 - 列出 Fabric 中的所有 VNI
  • vnisAddFabricVnis - 创建新的 VNI
  • vnisGetFabricVni - 获取指定 VNI 的详细信息
  • vnisUpdateFabricVni - 更新 VNI 配置
  • vnisDeleteFabricVni - 删除 VNI

• VNI 成员关系：成员接口管理

  • vnisGetFabricVniMembers - 列出 VNI 成员
  • vnisAddFabricVniMembers - 向 VNI 添加成员
  • vnisGetFabricVniMember - 获取指定成员的详细信息
  • vnisDeleteFabricVniMember - 从 VNI 中移除成员

�️ VRF 管理（9 个工具）

• 虚拟路由和转发：第 3 层网络隔离

  • vrfsGetFabricVrfs - 列出 Fabric 中的所有 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