Equinix Fabric MCP Server

Unofficial Equinix Fabric MCP Server v2.2

Python implementation - A Model Context Protocol (MCP) server that provides AI assistants with tools to interact with the Equinix Fabric API. This enables AI-powered management of network connections, ports, routers, and service profiles.

🚀 Features

Port Management

• List all Fabric ports in your account
• Get detailed information about specific ports

Connection Management

• List all Fabric connections
• Get detailed connection information
• Create new virtual connections between endpoints
• Update existing connections (bandwidth, name, description)
• Delete connections
• Get connection statistics (deprecated in Fabric v4)
• Search connections by filters
• Validate connection configurations before creation

Cloud Router Management

• List all Fabric Cloud Routers
• Get detailed router information
• ⚠️ Note: Create/Update/Delete operations are not supported in the current Fabric MCP server

Service Profiles & Tokens

• List available service profiles (cloud providers and partners)
• Get service profile details
• Create and manage service tokens for partner connections
• List and delete service tokens

Metro Locations

• List all available Equinix Fabric metro locations

📋 Prerequisites

• Python 3.10 or higher
• Claude Desktop application
• Equinix account with Fabric API access
• Equinix OAuth2 credentials (Client ID and Client Secret)

🔧 Installation

Method 1: Install from PyPI (Recommended)

pip install equinix-fabric-mcp

Method 2: Install from Source

git clone https://github.com/sliuuu/equinix-fabric-mcp.git
cd equinix-fabric-mcp
pip install -e .

⚙️ Configuration

Step 1: Get Your Equinix API Credentials

1. Log in to the Equinix Fabric Portal
2. Navigate to User Settings → API
3. Create an OAuth2 application to get:
   • Client ID
   • Client Secret
4. Save these credentials securely

Step 2: Configure Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "equinix-fabric": {
      "command": "python",
      "args": ["-m", "server"],
      "env": {
        "EQUINIX_CLIENT_ID": "your-client-id-here",
        "EQUINIX_CLIENT_SECRET": "your-client-secret-here"
      }
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "equinix-fabric": {
      "command": "equinix-fabric-mcp",
      "env": {
        "EQUINIX_CLIENT_ID": "your-client-id-here",
        "EQUINIX_CLIENT_SECRET": "your-client-secret-here"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Completely quit and reopen Claude Desktop for changes to take effect.

💡 Usage Examples

Once configured, you can ask Claude to help with Equinix Fabric tasks:

Read Operations

"List all my Fabric ports"
"Show me details about port [UUID]"
"List all my connections"
"Show me available service profiles for AWS"
"List all metros in Asia"
"Search for connections with state ACTIVE"

Write Operations

"Create a connection between my Singapore port and AWS Direct Connect"
"Update connection [UUID] to 1000 Mbps bandwidth"
"Delete connection [UUID]"
"Create a service token for my Hong Kong port"
"Validate this connection configuration before creating it"

Complex Workflows

"Set up redundant connections from Singapore to Tokyo"
"Create a multi-cloud hub in New York connecting to AWS, Azure, and GCP"
"Show me all ACTIVE connections and their bandwidth usage"

🔐 Authentication

This server uses OAuth2 Client Credentials flow for authentication:

• Access tokens are automatically obtained and cached
• Tokens are refreshed automatically before expiration (1 minute buffer)
• More secure than API key authentication
• Supports fine-grained permission control

🛠️ Available Tools

The server provides 22 MCP tools:

Read Operations (9 tools)

1. list_fabric_ports - List all ports
2. get_fabric_port - Get port details
3. list_fabric_connections - List connections
4. get_fabric_connection - Get connection details
5. get_connection_stats - Deprecated (not supported in Fabric v4)
6. list_fabric_routers - List Cloud Routers
7. get_fabric_router - Get router details
8. search_connections - Search with filters
9. list_metros - List metro locations

Connection Management (4 tools)

10. create_fabric_connection - Create new connections
11. update_connection - Modify connections
12. delete_connection - Remove connections
13. validate_connection_config - Pre-validate configs

Cloud Router Management (3 tools) ⚠️ **READ-ONLY**

14. create_fabric_router - Not supported in the current Fabric MCP server
15. update_fabric_router - Not supported in the current Fabric MCP server