TP-Link BE3600

Provides programmatic access to router status, devices, and port forwarding via an MCP server.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "consigcody94-mcp-tplink-router": {
      "command": "/path/to/mcp-tplink-router/venv/bin/python",
      "args": [
        "-m",
        "mcp_tplink_router"
      ],
      "env": {
        "TPLINK_HOST": "192.168.0.1",
        "TPLINK_PASSWORD": "your_password",
        "TPLINK_USERNAME": "admin"
      }
    }
  }
}

You can run a dedicated MCP (Model Context Protocol) server that automates and exposes control over a TP-Link BE3600 router using Python. This server lets you query router status, list connected devices, manage port forwarding, fetch DHCP settings, and orchestrate actions from AI tools, all through a simple, scriptable interface.

How to use

Configure your environment and run the MCP server from your project. You will provide your router’s address and credentials, then use the exposed tools to monitor the router, view port forwarding rules, and add or modify port forwards from your scripts or AI workflows.

How to install

Prerequisites include Python 3.10+ so you can run the MCP server and its dependencies.

Configuration and usage details

The MCP server runs as a local stdio service. You start it by invoking the Python module from within your virtual environment so it can be launched by external clients such as Claude Desktop.

{
  "mcpServers": {
    "tplink_router": {
      "command": "/path/to/mcp-tplink-router/venv/bin/python",
      "args": ["-m", "mcp_tplink_router"],
      "env": {
        "TPLINK_HOST": "192.168.0.1",
        "TPLINK_USERNAME": "admin",
        "TPLINK_PASSWORD": "your_password"
      }
    }
  }
}

Examples and available MCP tools

You can query router status, list connected devices, list port forwarding rules, add a new port forwarding rule, or retrieve diagnostics through the MCP server.

Security and best practices

Keep router credentials secure and limit access to the MCP server. Use environment variables to avoid hard-coding passwords in scripts, and consider restricting AI tool access to trusted environments.

Troubleshooting

If the MCP server cannot authenticate or connect to the router, verify that the host IP, username, and password values are correct and that the router is reachable from the machine running the MCP server.

Notes

This server leverages browser-based automation to interact with the router’s web UI and exposes high-level actions through the MCP interface. It is designed to be used from automation tools and AI assistants that integrate with MCP servers.

Available tools

router_status

Get router status including WAN info

list_connected_devices

List all devices currently connected to the router

list_port_forwarding

List all port forwarding rules configured on the router

add_port_forwarding

Add a new port forwarding rule for a host and port range

router_diagnostics

Get diagnostic information from the router