🌐 Nornir MCP Server

Name: 🌐 Nornir MCP Server
Author: yhvh-chen

@yhvh-chen

Repository

About 🌐 Nornir MCP Server

Nornir MCP Server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nornir_mcp_local": {
      "name": "Nornir MCP Server",
      "type": "sse",
      "url": "http://YOUR_SERVER_IP:8000/sse",
      "command": "DON'T NEED"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🌐 Nornir MCP Server?

A FastMCP server that provides network automation tools powered by Nornir and NAPALM. It bridges Nornir/NAPALM network operations as MCP (Massively Concurrent Processing) tools, making them accessible from compatible MCP clients. Designed for network engineers and automation practitioners.

How to use 🌐 Nornir MCP Server?

Configure network inventory and device credentials by editing hosts.yaml, groups.yaml, and defaults.yaml in the conf/ directory. Then run docker-compose up --build -d in the project root. The server starts on port 8000 using SSE transport. Connect an MCP client (e.g., FastMCP Web UI) by adding a server with URL http://localhost:8000/sse.

Key features of 🌐 Nornir MCP Server

Leverages Nornir for inventory management and concurrent task execution.
Uses NAPALM for multi-vendor device interaction and information gathering.
Built with FastMCP for seamless integration with MCP clients.
Containerized with Docker for easy setup and deployment.
Uses uv for fast Python dependency management within the container.
Provides tools for sending read-only commands and retrieving device facts.

Use cases of 🌐 Nornir MCP Server

Retrieve device facts (facts, interfaces, IP addresses, ARP tables, etc.) from multi-vendor networks.
Send read-only commands to network devices and collect output.
Perform automated device health checks and generate assessment reports.
Integrate network automation into larger MCP-based orchestration workflows.

FAQ from 🌐 Nornir MCP Server

What are the prerequisites to run the server?

Docker and Docker Compose (usually included with Docker Desktop) must be installed on your system.

How do I configure device credentials?

Edit hosts.yaml, groups.yaml, and defaults.yaml in the conf/ directory. Credentials are stored in plaintext by default – for production environments, use Nornir's secrets management features (e.g., environment variables or HashiCorp Vault) instead.

What tools does the server expose?

Tools include list_all_hosts, numerous NAPALM getters (e.g., get_facts, get_interfaces, get_config, get_bgp_neighbors), and send_command for read-only command execution. Availability depends on device platform and NAPALM driver support.

How do I connect an MCP client to the server?

Ensure the server is running, then add a new MCP Server connection in your client with the URL http://localhost:8000/sse. The client will automatically discover the available tools.

Is this server suitable for production use?

The default configuration stores credentials in plaintext YAML files, which is only recommended for lab/testing environments. For production, modify nornir_ops.py and configuration to use a secrets provider (e.g., environment variables or HashiCorp Vault).