Nornir MCP Server logo

Nornir MCP Server

by yhvh-chen

The Nornir MCP Server is a bridge that exposes Nornir/NAPALM network operations as MCP tools. It makes network automation tools easily accessible from compatible MCP clients.

View on GitHub

Last updated: N/A

What is Nornir MCP Server?

The Nornir MCP Server is a FastMCP server that leverages Nornir for inventory management and concurrent task execution, and NAPALM for multi-vendor device interaction, exposing network operations as MCP tools.

How to use Nornir MCP Server?

To use the server, configure your network inventory in the conf/ directory, run the server using Docker Compose (docker-compose up --build -d), and then add the server connection to your MCP client (like the FastMCP Web UI) using the server URL (e.g., 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.

  • 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.

Use cases of Nornir MCP Server

  • Automated network device configuration management.

  • Retrieving network device information (facts, interfaces, configurations).

  • Executing commands on multiple network devices concurrently.

  • Integrating network automation tasks into a centralized management platform.

FAQ from Nornir MCP Server

What is Nornir?

Nornir is a Python automation framework that helps manage and automate network devices.

What is NAPALM?

NAPALM (Network Automation and Programmability Abstraction Layer with Multivendor support) is a Python library that provides a unified API for interacting with different network device operating systems.

What is FastMCP?

FastMCP is a framework for building Massively Concurrent Processing (MCP) applications.

How do I configure device credentials?

Device credentials are configured in the conf/defaults.yaml file. However, for production environments, it is strongly recommended to use Nornir's built-in secrets management features.

What tools are available through the server?

Available tools include inventory listing (list_all_hosts), NAPALM getters (get_facts, get_interfaces, etc.), and execution commands (send_command).