pyATS MCP Server
This project implements a Model Context Protocol (MCP) Server that wraps Cisco pyATS and Genie functionality. It enables structured, model-driven interaction with network devices over STDIO using the JSON-RPC 2.0 protocol.
🚨 This server does not use HTTP or SSE. All communication is done via STDIN/STDOUT (standard input/output), making it ideal for secure, embedded, containerized, or LangGraph-based tool integrations.
🔧 What It Does
Connects to Cisco IOS/NX-OS devices defined in a pyATS testbed
Supports safe execution of validated CLI commands (show, ping)
Allows controlled configuration changes
Returns structured (parsed) or raw output
Exposes a set of well-defined tools via tools/discover and tools/call
Operates entirely via STDIO for minimal surface area and maximum portability
🚀 Usage
- Set your testbed path
export PYATS_TESTBED_PATH=/absolute/path/to/testbed.yaml
- Run the server
Continuous STDIO Mode (default)
python3 pyats_mcp_server.py
Launches a long-running process that reads JSON-RPC requests from stdin and writes responses to stdout.
One-Shot Mode
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/discover"}' | python3 pyats_mcp_server.py --oneshot
Processes a single JSON-RPC request and exits.
📦 Docker Support
Build the container
docker build -t pyats-mcp-server .
Run the container (STDIO Mode)
docker run -i --rm \
-e PYATS_TESTBED_PATH=/app/testbed.yaml \
-v /your/testbed/folder:/app \
pyats-mcp-server
🧠 Available MCP Tools
Tool Description
run_show_command Executes show commands safely with optional parsing
run_ping_command Executes ping tests and returns parsed or raw results
apply_configuration Applies safe configuration commands (multi-line supported)
learn_config Fetches running config (show run brief)
learn_logging Fetches system logs (show logging last 250)
All inputs are validated using Pydantic schemas for safety and consistency.
🤖 LangGraph Integration
Add the MCP server as a tool node in your LangGraph pipeline like so:
("pyats-mcp", ["python3", "pyats_mcp_server.py", "--oneshot"], "tools/discover", "tools/call")
Name: pyats-mcp
Command: python3 pyats_mcp_server.py --oneshot
Discover Method: tools/discover
Call Method: tools/call
STDIO-based communication ensures tight integration with LangGraph’s tool invocation model without opening HTTP ports or exposing REST endpoints.
📜 Example Requests
Discover Tools
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/discover"
}
Run Show Command
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "run_show_command",
"arguments": {
"device_name": "router1",
"command": "show ip interface brief"
}
}
}
🔒 Security Features
Input validation using Pydantic
Blocks unsafe commands like erase, reload, write
Prevents pipe/redirect abuse (e.g., | include, >, copy, etc.)
Gracefully handles parsing fallbacks and errors
📁 Project Structure
.
├── pyats_mcp_server.py # MCP server with JSON-RPC and pyATS integration
├── Dockerfile # Docker container definition
├── testbed.yaml # pyATS testbed (user-provided)
└── README.md # This file
📥 MCP Server Config Example (pyATS MCP via Docker)
To run the pyATS MCP Server as a container with STDIO integration, configure your mcpServers like this:
{
"mcpServers": {
"pyats": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PYATS_TESTBED_PATH",
"-v",
"/absolute/path/to/testbed/folder:/app",
"pyats-mcp-server"
],
"env": {
"PYATS_TESTBED_PATH": "/app/testbed.yaml"
}
}
}
}
{
"servers": {
"pyats": {
"type": "stdio",
"command": "python3",
"args": [
"-u",
"/Users/johncapobianco/pyATS_MCP/pyats_mcp_server.py"
],
"env": {
"PYATS_TESTBED_PATH": "/Users/johncapobianco/pyATS_MCP/testbed.yaml"
}
}
}
🧾 Explanation: command: Uses Docker to launch the containerized pyATS MCP server
args:
-i: Keeps STDIN open for communication
--rm: Automatically removes the container after execution
-e: Injects the environment variable PYATS_TESTBED_PATH
-v: Mounts your local testbed directory into the container
pyats-mcp-server: Name of the Docker image
env:
Sets the path to the testbed file inside the container (/app/testbed.yaml)
✍️ Author
John Capobianco
Product Marketing Evangelist, Selector AI
Author, Automate Your Network
Let me know if you’d like to add:
A sample LangGraph graph config
Companion client script
CI/CD integration (e.g., GitHub Actions)
Happy to help!
The testbed.yaml file works with the Cisco DevNet Cisco Modeling Labs (CML) Sandbox!
Metadata
Release files for iflow-mcp_automateyournetwork-pyats_mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_automateyournetwork_pyats_mcp-0.1.0.tar.gz | 11.4 kB | Without provenance | Details for iflow_mcp_automateyournetwork_pyats_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_automateyournetwork_pyats_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_automateyournetwork_pyats_mcp-0.1.0-py3-none-any.whl |
Total release size: 30.8 kB
Release files / iflow_mcp_automateyournetwork_pyats_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_automateyournetwork_pyats_mcp-0.1.0.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bd20cc58da88b993f46c08f37cdc7146ddb6c9c2c7487f881ed6ae90e2358481
|
|
BLAKE2b-256 checksum How to use checksums |
5a25f118ef05bb4d3bb1a103b7f06e0c0d714699bb134b89374f2714403af1c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_automateyournetwork_pyats_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_automateyournetwork_pyats_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 19.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7359e98608c46d033e1f9954235acf78a086cb7ef4840b19fe89392270dc666b
|
|
BLAKE2b-256 checksum How to use checksums |
716c568e6bb7d469344898e4180bc3a019280af05d5b8bbb467567587481e9e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_automateyournetwork-pyats_mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.