TP-Link Router Model Context Protocol (MCP) Server

Universal, Agent-Safe Model Context Protocol (MCP 2.x) Server for TP-Link Routers. Connects TP-Link 4G/LTE gateways and broadband routers directly to autonomous AI copilots (Google Antigravity, Claude Desktop, Cursor, Codex) with 18 typed tools, single-admin session leasing, and disconnection safeguards.

👨‍💻 Author & Origin Story

Created & Architected by: Dulith Divisekara
Undergraduate in Information Technology, Sri Lanka Institute of Information Technology (SLIIT), Malabe, Sri Lanka.

Origin: Autonomous 4G LTE Optimization

Built to enable AI coding assistants and autonomous agents to diagnose, monitor, and optimize an active Hutch Sri Lanka 4G LTE unlimited 20 Mbps SIM running on a TP-Link Archer MR200 v5 router in Malabe (near SLIIT Campus).

Equipped with an automatic Network Guard that prevents autonomous AI agents from ever executing commands if the host is connected to university campus Wi-Fi or a mobile hotspot.

Related MCP server: omada-mcp

🚀 Quickstart for AI Copilots ($0 Cost)

1. Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tplink-mcp": {
      "command": "npx",
      "args": ["-y", "tplink-mcp"],
      "env": {
        "TPLINK_ROUTER_IP": "http://192.168.1.1",
        "TPLINK_PASSWORD": "your_router_password"
      }
    }
  }
}

2. Google Antigravity & Cursor Configuration

Configure directly via standard Python stdio transport:

{
  "mcpServers": {
    "tplink-mcp": {
      "command": "python3",
      "args": ["-m", "tplink_mcp.server"],
      "env": {
        "TPLINK_ROUTER_IP": "http://192.168.1.1",
        "TPLINK_PASSWORD": "your_router_password"
      }
    }
  }
}

3. Docker Container (Zero-Install)

docker run -i --rm --network host \
  -e TPLINK_ROUTER_IP="http://192.168.1.1" \
  -e TPLINK_PASSWORD="your_router_password" \
  ghcr.io/dulithdivisekara/tplink-mcp:latest

🛠️ Complete MCP Tools Catalog (18 Typed Tools)

Following the official MCP Best Practices, tools are categorized into safe read-only inspectors and guarded mutation tools:

🔒 Safety Guardrails for Autonomous AI Agents

1. Atomic Session Leasing (SafeSession): Automatically authenticates, executes the tool, and releases the session immediately so your browser (192.168.1.1) is never locked out.

2. Disconnection Prevention (confirm=True): Potentially disruptive actions like router_reboot or router_set_cell_lock require an explicit boolean confirmation flag to prevent an autonomous agent from severing its own active session.

3. Multi-Environment Network Guard: Blocks execution if your laptop is currently on university Wi-Fi or personal hotspot.

🧪 Testing

python3 -m unittest discover tests

📄 License

MIT License. Created by Dulith Divisekara.