Manage various router types using natural language. Requires router credentials to be configured.
A Model Context Protocol (MCP) server for natural language router management. Control your network infrastructure through Claude with support for multiple router types. Named after the AI tanks from Ghost in the Shell - because your router deserves to be sentient!
π Multi-Router Support
π οΈ Core Capabilities
π€ Natural Language Interface
git clone https://github.com/SamuraiBuddha/mcp-tachikoma-router.git
cd mcp-tachikoma-router
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your router details
{
"mcpServers": {
"tachikoma-router": {
"command": "python",
"args": ["-m", "mcp_router_manager"],
"cwd": "/path/to/mcp-tachikoma-router"
}
}
}
python scripts/detect_router.py 192.168.1.1
For the EVA Network infrastructure:
# In Claude:
"Connect to router at 192.168.50.1"
"Setup EVA network with static IPs for all nodes"
This automatically configures:
# Connect to router
"Connect to my router at 192.168.1.1"
# List devices
"Show all connected devices"
"List DHCP reservations"
# Add static IP
"Give my NAS a static IP at 192.168.1.100"
"Reserve 192.168.50.10 for device with MAC aa:bb:cc:dd:ee:ff"
# Port forwarding
"Forward port 9000 to my Portainer server"
"Open port 22 to 192.168.1.50 for SSH"
# Backup
"Backup router configuration"
"Restore configuration from backup"
# Firewall rules
"Block all traffic from 192.168.1.99"
"Allow only port 80 and 443 from guest network"
# Network monitoring
"Show bandwidth usage for all devices"
"Which device is using the most bandwidth?"
# Bulk operations
"Set up static IPs for all my IoT devices"
"Forward ports 8000-8010 to my development server"
Claude Desktop
β
MCP Protocol
β
Tachikoma Router MCP
β
Router Abstraction Layer
β
ββββββββββ¬ββββββββ¬ββββββββββ¬ββββββββββ
βUniFi APIβASUS SSHβpfSense APIβOpenWRT RPCβ
ββββββββββ΄ββββββββ΄ββββββββββ΄ββββββββββ
# Router connection
ROUTER_IP=192.168.50.1
ROUTER_TYPE=auto # auto, unifi, asus, netgear, pfsense, openwrt
# Authentication
ROUTER_USERNAME=admin
ROUTER_PASSWORD=your_password
# UniFi specific
UNIFI_SITE=default
UNIFI_CONTROLLER=https://192.168.1.1:8443
# SSH (for ASUS/OpenWRT)
SSH_PORT=22
SSH_KEY_PATH=~/.ssh/id_rsa
# API Keys (if applicable)
API_KEY=your_api_key
π Best Practices:
π‘οΈ Built-in Protections:
# Test router connectivity
python scripts/test_connection.py
# Debug mode
ROUTER_DEBUG=true python -m mcp_router_manager
"Router type not detected"
"Authentication failed"
"Operation not supported"
Contributions welcome! Especially for:
This MCP is themed after Ghost in the Shell's Section 9:
Future MCPs in the Section 9 suite:
mcp-motoko-firewall
- Advanced firewall managementmcp-batou-monitor
- Network monitoring and alertsmcp-aramaki-orchestrator
- Multi-device orchestrationMIT License - See LICENSE file
"A router without natural language control is like a Tachikoma without oil - technically functional but missing its soul!" π¦
Mercado Pago's official MCP server, offering tools to interact with our API, simplifying tasks and product integration.
A simple note storage system that allows adding and summarizing notes using a custom URI scheme.
MCP server that connects to the whole Microsoft 365 suite (Microsoft Office, Outlook, Excel) using Graph API (including mail, files, calendar)
Interact with Home Assistant to control smart home devices, query states, manage automations, and troubleshoot your smart home setup.
A server that enables access to Joplin notes and to-dos through the Model Context Protocol (MCP).
a macOS-only MCP server that enables AI agents to capture screenshots of applications, or the entire system.
An intelligent tutoring server that uses GitHub documentation repositories to provide structured educational prompts and tools.
Human-in-the-loop platform - Allow AI agents and automations to send requests for approval to your gotoHuman inbox.
Interacting with Obsidian via REST API
Full implementation of Todoist Rest API for MCP server