# packet-tracer-mcp

Controls Cisco Packet Tracer 9 through MCP, creating topologies, configuring routers, and running simulations from an AI coding client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: Jcorderop02
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Jcorderop02/packet-tracer-mcp
- Updated: 2026-07-13
- HTML: https://affpapa.org/en/nevibecode/mcp/packet-tracer-mcp

## What it does

packet-tracer-mcp connects an MCP client to Cisco Packet Tracer 9. An agent can create network layouts, place devices, wire links, and send commands to router consoles. The listed scenarios cover IOS, OSPF, BGP, NAT, VLAN, VoIP, QoS, IPv6, and wireless networking.

The integration uses an MCP server, the `mcp-bridge.pts` Packet Tracer extension, and a local HTTP bridge. The extension forwards requests to Packet Tracer’s native IPC API. The server is written in TypeScript and runs with Bun, with HTTP and stdio modes available.

You need Cisco Packet Tracer 9.0, Bun `>=1.2`, and an active `mcp-bridge.pts` extension. This is an experimental project, so a Packet Tracer update can change its API and break the connection.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BRIDGE_PORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BRIDGE_PORT=<BRIDGE_PORT> --transport stdio packet-tracer-mcp -- npx -y packet-tracer-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add packet-tracer-mcp --env BRIDGE_PORT=<BRIDGE_PORT> -- npx -y packet-tracer-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "packet-tracer-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "packet-tracer-mcp"
            ],
            "env": {
                "BRIDGE_PORT": "<BRIDGE_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "packet-tracer-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "packet-tracer-mcp"
            ],
            "env": {
                "BRIDGE_PORT": "<BRIDGE_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BRIDGE_PORT=<BRIDGE_PORT> packet-tracer-mcp npx -y packet-tracer-mcp
```
Replace <…> with your own values

## When to use it
- build a topology in Cisco Packet Tracer
- place devices and connect them
- configure routers through IOS
- run a network simulation from an agent
- check the Packet Tracer bridge status

## Example prompts
- Create a Packet Tracer topology with two routers and configure OSPF between them.
- Add a VLAN and set up NAT on the router through IOS.
- Check the Packet Tracer connection and report the bridge status.

## Similar
- [Cisco Modeling Labs CML](https://affpapa.org/en/nevibecode/mcp/cisco-modeling-labs-cml.md) — MCP server · ★ 76
- [ios-networking](https://affpapa.org/en/nevibecode/skills/ios-networking.md) — skill · 4400 installs
- [axiom-networking](https://affpapa.org/en/nevibecode/skills/axiom-networking.md) — skill · 1500 installs
- [positioning-truth-tracer](https://affpapa.org/en/nevibecode/skills/positioning-truth-tracer.md) — skill · 1000 installs
- [svg-tracer](https://affpapa.org/en/nevibecode/mcp/svg-tracer.md) — MCP server · ★ 81
- [LinkedIn Automation](https://affpapa.org/en/nevibecode/skills/linkedin-automation.md) — skill · 5200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md