Skip to main content
Glama
Hyperfabric MCP Server

Hyperfabric MCP Server

by jim-coyne

Hyperfabric MCP Server

An MCP (Model Context Protocol) server that enables LLMs to interact with Hyperfabric APIs. This server exposes all 79 Hyperfabric OpenAPI endpoints as tools for comprehensive infrastructure management and automation.

🔧 Dynamic Tool Generation: Automatically parses Hyperfabric OpenAPI specs and creates MCP tools
🛡️ Secure Authentication: Handles Hyperfabric API token authentication with proper security
📊 Complete API Coverage: Exposes all 79 available Hyperfabric endpoints for infrastructure management
✨ Clean Tool Names: Tools display with intuitive names like fabricsGetAllFabrics for easy discovery

Prerequisites

  • Node.js 18+ installed

  • VSCode with GitHub Copilot or Claude Desktop

  • Hyperfabric API credentials (API Token)

  • Hyperfabric OpenAPI specification file

1. Build the Server

npm install
npm run build

2. Configure LLM Client

For VSCode with GitHub Copilot

  1. Open VSCode Settings: Cmd+Shift+P → "Preferences: Open User Settings (JSON)"

  2. Add this configuration to your 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"
      }
    }
  }
}
  1. Reload VS Code: Cmd+Shift+P → "Developer: Reload Window"

For Claude Desktop

  1. Locate your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Add this configuration to 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"
      }
    }
  }
}
  1. Restart Claude Desktop application

Hyperfabric MCP Configuration

Hyperfabric MCP Setup

Hyperfabric MCP Setup

Available Tools and Capabilities

The MCP server automatically generates 79 tools from the complete Nexus Hyperfabric REST API v1.1.0 specification:

� Authentication & User Management (9 tools)

  • Bearer Token Management: Secure API authentication

    • authGetBearerTokens - List all bearer tokens for the user

    • authCreateBearerTokens - Create new bearer tokens

    • authGetBearerToken - Get specific bearer token details

    • authDeleteBearerToken - Delete a specific bearer token

  • User Management: User account operations

    • authGetUsers - List all users in organization

    • authGetUser - Get specific user details

    • authSetUsers - Create or update users

    • authUpdateUser - Update existing user

    • authDeleteUser - Delete a user account

🖥️ Device Management (3 tools)

  • Device Operations: Physical device management and binding

    • devicesGetDevices - List all devices (bound and unbound)

    • devicesBindDevice - Bind a device to a fabric node

    • devicesUnbindDevice - Unbind device from a fabric node

🏗️ Fabric Management (16 tools)

  • Fabric Configuration: Core fabric operations

    • fabricsGetAllFabrics - List all fabrics in organization

    • fabricsAddFabrics - Create new fabrics

    • fabricsGetFabric - Get specific fabric details

    • fabricsUpdateFabric - Update fabric configuration

    • fabricsDeleteFabric - Delete a fabric

  • Connection Management: Fabric network connections

    • fabricsGetFabricConnections - List all connections in fabric

    • fabricsAddFabricConnections - Add new connections

    • fabricsGetFabricConnection - Get specific connection details

    • fabricsSetFabricConnections - Replace all connections

    • fabricsDeleteFabricConnections - Delete all connections

    • fabricsDeleteFabricConnection - Delete specific connection

  • Configuration Management: Candidate configurations and deployment

    • fabricsGetFabricCandidates - List candidate configurations

    • fabricsGetFabricCandidate - Get specific candidate config

    • fabricsCommitFabricCandidate - Deploy candidate to running config

    • fabricsRevertFabricCandidate - Discard candidate configuration

    • fabricsReviewFabricCandidate - Add comments to candidate config

🌐 Network Configuration (3 tools)

  • Spanning Tree Protocol: Global STP settings

    • networksGetFabricStp - Get fabric STP configuration

    • networksUpdateFabricStp - Update STP settings

    • networksResetFabricStp - Reset STP to defaults

� Node Management (25 tools)

  • Node Operations: Fabric node configuration

    • nodesGetFabricNodes - List all nodes in fabric

    • nodesAddFabricNodes - Add new nodes to fabric

    • nodesGetNamedFabricNode - Get specific node details

    • nodesUpdateFabricNode - Update node configuration

    • nodesDeleteFabricNode - Remove node from fabric

  • Port Management: Node port configuration

    • nodesGetPorts - List all ports for a node

    • nodesGetPort - Get specific port details

    • nodesUpdatePort - Update port configuration

    • nodesSetPorts - Replace all port configurations

    • nodesResetPort - Reset port to defaults

  • Management Ports: Out-of-band management interfaces

    • nodesGetManagementPorts - List management ports

    • nodesAddManagementPorts - Add management ports

    • nodesGetManagementPort - Get specific management port

    • nodesUpdateManagementPort - Update management port config

  • Loopback Interfaces: Virtual interfaces for routing

    • nodesGetNodeLoopbacks - List loopback interfaces

    • nodesAddNodeLoopbacks - Create loopback interfaces

    • nodesGetNodeLoopback - Get specific loopback details

    • nodesUpdateNodeLoopback - Update loopback configuration

    • nodesDeleteNodeLoopback - Delete loopback interface

  • Sub-Interfaces: VLAN and sub-interface configuration

    • nodesGetNodeSubInterfaces - List sub-interfaces

    • nodesAddNodeSubInterfaces - Create sub-interfaces

    • nodesGetNodeSubInterface - Get specific sub-interface

    • nodesUpdateNodeSubInterface - Update sub-interface config

    • nodesDeleteNodeSubInterface - Delete sub-interface

� Port Channel Management (5 tools)

  • Link Aggregation: Port channel operations

    • portchannelsGetAllPortChannels - List all port channels

    • portchannelsAddPortChannels - Create port channels

    • portchannelsGetPortChannel - Get specific port channel

    • portchannelsUpdatePortChannel - Update port channel config

    • portchannelsDeletePortChannel - Delete port channel

🏷️ VNI Management (9 tools)

  • Virtual Network Identifiers: VXLAN network segmentation

    • vnisGetFabricVnis - List all VNIs in fabric

    • vnisAddFabricVnis - Create new VNIs

    • vnisGetFabricVni - Get specific VNI details

    • vnisUpdateFabricVni - Update VNI configuration

    • vnisDeleteFabricVni - Delete VNI

  • VNI Membership: Member interface management

    • vnisGetFabricVniMembers - List VNI members

    • vnisAddFabricVniMembers - Add members to VNI

    • vnisGetFabricVniMember - Get specific member details

    • vnisDeleteFabricVniMember - Remove member from VNI

�️ VRF Management (9 tools)

  • Virtual Routing and Forwarding: Layer 3 network isolation

    • vrfsGetFabricVrfs - List all VRFs in fabric

    • vrfsAddFabricVrfs - Create new VRFs

    • vrfsGetFabricVrf - Get specific VRF details

    • vrfsUpdateFabricVrf - Update VRF configuration

    • vrfsDeleteFabricVrf - Delete VRF

  • Static Routing: Static route management within VRFs

    • vrfsGetFabricStaticRoutes - List static routes in VRF

    • vrfsAddFabricStaticRoutes - Add static routes

    • vrfsGetFabricStaticRoute - Get specific route details

    • vrfsUpdateFabricStaticRoute - Update static route

    • vrfsDeleteFabricStaticRoute - Delete static route

Related MCP server: network-mcp

Environment Variables

Variable

Description

Default

Required

HYPERFABRIC_API_TOKEN

Your Hyperfabric API token

-

✅

LOG_LEVEL

Logging level (debug, info, warn, error)

info

❌

OPENAPI_SPEC_PATH

Path to OpenAPI spec file

hf_spec_modified.json

❌

Development Setup

Project Structure

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

Troubleshooting

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

Available Tools

79 tools
authCreateBearerTokensC

Add one or more bearer tokens.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: tokens.

authDeleteBearerTokenC

Delete a specific bearer token.

Inputs: tokenId (required).

authDeleteUserC

Delete a specific user.

Inputs: userId (required).

authGetBearerTokenC

Get a specific bearer token.

Inputs: tokenId (required), includeMetadata.

authGetBearerTokensC

Get the list of bearer tokens.

Inputs: includeMetadata.

authGetUserC

Get a specific user.

Inputs: userId (required), includeMetadata.

authGetUsersC

Get a list of users.

Inputs: emails, enabled, roles, includeMetadata.

authSetUsersC

Add one or more users.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: users.

authUpdateUserC

Update a specific user.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: userId (required), enabled, labels, role.

devicesBindDeviceC

Bind a specific device to a node.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), deviceId (required).

devicesGetDevicesC

Get the list of devices.

Inputs: no named parameters.

devicesUnbindDeviceC

Unbind the bound device from a node.

Inputs: fabricId (required), nodeId (required).

fabricsAddFabricConnectionsC

Add one or more connections.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), connections.

fabricsAddFabricsC

Add a fabric.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabrics.

fabricsCommitFabricCandidateC

Commit a specific candidate configuration.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), name (required), comments (required), revisionId.

fabricsDeleteFabricC

Delete a specific fabric.

Inputs: fabricId (required).

fabricsDeleteFabricConnectionC

Delete a specific connection.

Inputs: fabricId (required), connectionId (required).

fabricsDeleteFabricConnectionsC

Delete all connections.

Inputs: fabricId (required).

fabricsGetAllFabricsC

Get the list of fabrics.

Inputs: fabricId, candidate, includeMetadata, max, +1 more.

fabricsGetFabricC

Get a specific fabric.

Inputs: fabricId (required), candidate, includeMetadata.

fabricsGetFabricCandidateC

Get a specific candidate configuration.

Inputs: fabricId (required), name (required), needInactive, needReviews, +1 more.

fabricsGetFabricCandidatesC

Get the list of candidate configurations.

Inputs: fabricId (required), name, txnId, needInactive, +6 more.

fabricsGetFabricConnectionC

Get a specific connection.

Inputs: fabricId (required), connectionId (required), candidate.

fabricsGetFabricConnectionsC

Get the list of connections.

Inputs: fabricId (required), candidate.

fabricsRevertFabricCandidateC

Discard a specific candidate configuration.

Inputs: fabricId (required), name (required).

fabricsReviewFabricCandidateC

Comment on a specific candidate configuration.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), name (required), comments.

fabricsSetFabricConnectionsC

Update the list of connections.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), connections.

fabricsUpdateFabricC

Update a specific fabric.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), name (required), address, annotations, +7 more.

networksGetFabricStpC

Get fabric spanning tree protocol settings.

Inputs: fabricId (required), candidate, includeMetadata.

networksResetFabricStpC

Reset fabric spanning tree protocol settings.

Inputs: fabricId (required).

networksUpdateFabricStpC

Update fabric spanning tree protocol settings.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), enabled, metadata, priority, +1 more.

nodesAddFabricNodesC

Add one or more nodes.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), nodes.

nodesAddManagementPortsC

Add one or more management port.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), nodeId (required), ports.

nodesAddNodeLoopbacksC

Add one or more loopbacks.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), nodeId (required), loopbacks.

nodesAddNodeSubInterfacesC

Add one or more sub-interfaces.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), nodeId (required), subInterfaces.

nodesDeleteFabricNodeC

Delete a specific node.

Inputs: fabricId (required), nodeId (required).

nodesDeleteNodeLoopbackC

Delete a specific loopback.

Inputs: fabricId (required), nodeId (required), loopbackId (required).

nodesDeleteNodeSubInterfaceC

Delete a specific sub-interface.

Inputs: fabricId (required), nodeId (required), subInterfaceId (required).

nodesGetFabricNodesC

Get the list of nodes.

Inputs: fabricId (required), candidate, includeMetadata.

nodesGetManagementPortC

Get a specific management port.

Inputs: fabricId (required), nodeId (required), id (required), candidate, +1 more.

nodesGetManagementPortsC

Get the list of management ports.

Inputs: fabricId (required), nodeId (required), candidate, includeMetadata.

nodesGetNamedFabricNodeC

Get a specific node.

Inputs: fabricId (required), nodeId (required), candidate, includeMetadata.

nodesGetNodeLoopbackC

Get a specific loopback.

Inputs: fabricId (required), nodeId (required), loopbackId (required), candidate, +1 more.

nodesGetNodeLoopbacksB

Get the list of loopbacks.

Inputs: fabricId (required), nodeId (required), candidate, includeMetadata.

nodesGetNodeSubInterfaceC

Get a specific sub-interface.

Inputs: fabricId (required), nodeId (required), subInterfaceId (required), candidate, +1 more.

nodesGetNodeSubInterfacesC

Get the list of sub-interfaces.

Inputs: fabricId (required), nodeId (required), candidate, includeMetadata.

nodesGetPortC

Get a specific port.

Inputs: fabricId (required), nodeId (required), portId (required), candidate, +1 more.

nodesGetPortsC

Get the list of ports.

Inputs: fabricId (required), nodeId (required), candidate, includeMetadata.

nodesResetPortC

Reset a specific port.

Inputs: fabricId (required), nodeId (required), portId (required).

nodesSetPortsB

Update the list of ports.

[SAFE OPERATION] This tool configures network fabric port settings (speed, MTU, VLAN, etc.) via REST API. It does NOT execute code or commands on the system.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), ports.

nodesUpdateFabricNodeC

Update a specific node.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), annotations, description, +10 more.

nodesUpdateManagementPortC

Update a specific management port.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), id (required), cloudUrls, +21 more.

nodesUpdateNodeLoopbackC

Update a specific loopback.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), loopbackId (required), annotations, +9 more.

nodesUpdateNodeSubInterfaceC

Update a specific sub-interface.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), subInterfaceId (required), annotations, +11 more.

nodesUpdatePortA

Update a specific port.

[SAFE OPERATION] This tool configures network fabric port settings (speed, MTU, VLAN, etc.) via REST API. It does NOT execute code or commands on the system.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), nodeId (required), portId (required), annotations, +26 more.

portchannelsAddPortChannelsC

Add one or more port channels.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), portChannels.

portchannelsDeletePortChannelC

Delete a specific port channel.

Inputs: fabricId (required), id (required).

portchannelsGetAllPortChannelsC

Get the list of port channels.

Inputs: fabricId (required), candidate, includeMetadata.

portchannelsGetPortChannelB

Get a specific port channel.

Inputs: fabricId (required), id (required), candidate, includeMetadata.

portchannelsUpdatePortChannelC

Update a specific port channel.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), id (required), annotations, description, +13 more.

vnisAddFabricVniMembersC

Add one or more VNI members.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), vniId (required), members.

vnisAddFabricVnisC

Add one or more VNIs.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), vnis.

vnisDeleteFabricVniC

Delete a specific VNI.

Inputs: fabricId (required), vniId (required).

vnisDeleteFabricVniMemberC

Delete a specific VNI member.

Inputs: fabricId (required), vniId (required), memberId (required).

vnisGetFabricVniC

Get a specific VNI.

Inputs: fabricId (required), vniId (required), candidate, includeMetadata.

vnisGetFabricVniMemberC

Get a specific VNI member.

Inputs: fabricId (required), vniId (required), memberId (required), candidate, +1 more.

vnisGetFabricVniMembersC

Get the list of VNI members.

Inputs: fabricId (required), vniId (required), candidate, includeMetadata.

vnisGetFabricVnisC

Get the list of VNIs.

Inputs: fabricId (required), candidate, includeMetadata.

vnisUpdateFabricVniC

Update a specific VNI.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), vniId (required), annotations, description, +8 more.

vrfsAddFabricStaticRoutesC

Add one or more static routes.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), vrfId (required), staticRoutes.

vrfsAddFabricVrfsC

Add one or more VRFs.

To use this tool, pass the required fields as direct arguments (e.g., fabrics=[{name:"my-fabric", description:"...", ...}])

Inputs: fabricId (required), vrfs.

vrfsDeleteFabricStaticRouteC

Delete a specific static route.

Inputs: fabricId (required), vrfId (required), routeId (required).

vrfsDeleteFabricVrfC

Delete a specific VRF.

Inputs: fabricId (required), vrfId (required).

vrfsGetFabricStaticRouteC

Get a specific static route.

Inputs: fabricId (required), vrfId (required), routeId (required), candidate, +1 more.

vrfsGetFabricStaticRoutesC

Get the list of static routes.

Inputs: fabricId (required), vrfId (required), candidate, includeMetadata.

vrfsGetFabricVrfC

Get a specific VRF.

Inputs: fabricId (required), vrfId (required), candidate, includeMetadata.

vrfsGetFabricVrfsC

Get the list of VRFs.

Inputs: fabricId (required), candidate, includeMetadata.

vrfsUpdateFabricStaticRouteC

Update a specific static route.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), vrfId (required), routeId (required), annotations, +7 more.

vrfsUpdateFabricVrfC

Update a specific VRF.

To use this tool, pass the resource ID and the fields to update as arguments

Inputs: fabricId (required), vrfId (required), annotations, asn, +9 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 79 tools

    Disambiguation4/5

    Tools are well-organized by resource categories (auth, devices, fabrics, nodes, etc.) with clear distinctions between actions like get, add, update, and delete. However, some potential overlaps exist, such as multiple 'add' tools for different sub-resources within a category that might be confusing if the agent doesn't carefully parse the resource type.

    Naming Consistency5/5

    Naming follows a highly consistent pattern: resourceActionResource or resourceActionResources (e.g., authGetUser, fabricsAddFabrics, nodesUpdatePort). All tools use camelCase uniformly, and the verb-noun structure is predictable across all 79 tools, making them easy to parse and understand.

    Tool Count2/5

    With 79 tools, the count is excessive for typical MCP server purposes, likely overwhelming for agents and users. While the domain (network fabric management) is complex, this many tools suggests over-fragmentation of operations that could have been consolidated, making it heavy and difficult to navigate.

    Completeness5/5

    The tool set provides comprehensive CRUD coverage across all major resources (fabrics, nodes, ports, VRFs, VNIs, etc.), including lifecycle operations like commit, revert, and review for candidates. No obvious gaps are present; agents can perform full management workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to interact with Cisco Intersight APIs for managing data center infrastructure, including server monitoring, policy management, network configuration, and hardware telemetry across 199 tools.
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with direct access to multi-vendor network devices for tasks like configuration management, health checks, and topology discovery through 35 specialized tools. It enables natural language control over platforms including Cisco, Juniper, and Nokia using SSH, NETCONF, and SNMP protocols.
      12
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes 90 production-grade tools for interacting with the complete HPE Aruba Networking Central REST API surface, including network inventory, configuration, and security management. It features enterprise-ready OAuth2 handling and semantic tool filtering for optimized performance with both hosted and local LLMs.
      -