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.

Features

🛡️ Secure Authentication: Handles Hyperfabric API token authentication with proper security
📊 Complete API Coverage: Exposes all 79 available Hyperfabric endpoints for infrastructure management

Prerequisites

• Node.js 18+ installed
• VSCode with GitHub Copilot or Claude Desktop
• Hyperfabric API credentials (API Token)
• Hyperfabric OpenAPI specification file

Installation

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"
      }
    }
  }
}

3. 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"
      }
    }
  }
}

3. Restart Claude Desktop application

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