Routing Director MCP Server

An MCP (Model Context Protocol) server that integrates with Juniper's Routing Director platform, providing intelligent access to network routing, assurance, optimization, and intelligence capabilities.

Features

• Flexible Authentication: Supports both basic and token-based authentication
• Multiple Transport Options: HTTP and stdio transport protocols
• Device management and monitoring
• Configuration template deployment
• VPN service management
• Network topology visualization
• KPI monitoring and observability
• Customer and organization management

Prerequisites

• Python 3.10 or 3.11
• Juniper Routing Director instance
• Network connectivity to Routing Director API
• Valid Routing Director credentials (username/password or API token)

Installation

From Source

git clone https://github.com/Juniper/routing-director-mcp-server.git
cd routing-director-mcp-server
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

From MCP Registry

TBD

Configuration

Configuration File (config.json)

Create a config.json file with the following structure:

Basic Authentication:

{
  "http_url": "https://your-routing-director-host/",
  "org_id": "your-organization-id",
  "auth": {
    "type": "basic",
    "username": "your-username@example.com",
    "password": "your-password"
  }
}

Token Authentication:

{
  "http_url": "https://your-routing-director-host/",
  "org_id": "your-organization-id",
  "auth": {
    "type": "token",
    "token": "your-api-token"
  }
}

Note: This authentication is between the MCP server and the Routing Director instance. The MCP server will handle authentication with Routing Director on behalf of clients connecting to it.

Configuration Parameters

• http_url (required): URL of your Routing Director instance
• org_id (required): Your organization ID in Routing Director
• auth (required): Authentication configuration
  • type: Either basic or token
  • username: Routing Director username (for basic auth)
  • password: Routing Director password (for basic auth)
  • token: API token (for token auth)
• components (optional): Additional component configuration to filter tools and capabilities exposed by the MCP server. If the user wishes to filter the openapi spec only for certain components, then the components field can be used to provide a list of components to filter the spec.

Components can be one of the following:

• ems - For alarms related info (searching, ack and unack of alarms reported on Routing Director)
• juniper-resiliency-interface - For device syslog info (retrieving syslog messages collected on Routing Director)
• device-kpi - For fetching exception events related to Juniper Resiliency Interface (JRI) collected on Routing Director(forwarding, routing and os)

Usage

Starting the Server

python RoutingDirectorMCP.py --config config.json

Command Line Options

python RoutingDirectorMCP.py --help

Available options:

• -H, --host: Server host (default: 127.0.0.1)
• -p, --port: Server port (default: 30030)
• -t, --transport: Transport type: streamable-http or stdio (default: streamable-http)
• -c, --config: Path to configuration file (required)
• -v, --verbose: Enable verbose logging

Example: Start with Custom Configuration

python RoutingDirectorMCP.py \
  --config config.json \
  --host localhost \
  --port 8000 \
  --transport streamable-http \
  --verbose

Authentication between the MCP Server and the MCP Host(Claude/Copilot etc)

Token Management

The server supports token-based authentication through a token manager. If a tokens file exists, authentication is automatically enabled for HTTP transports.

For stdio transport, authentication is bypas

... View full README on GitHub