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.
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?
What is Nornir?
Nornir is a Python automation framework that helps manage and automate network devices.
What is NAPALM?
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?
What is FastMCP?
FastMCP is a framework for building Massively Concurrent Processing (MCP) applications.
How do I configure device credentials?
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?
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
).