@usex/mikrotik-mcp 3.6.0 → 3.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -7
- package/dist/cli.js +2303 -1914
- package/dist/index.js +2299 -1910
- package/package.json +1 -1
- package/schemas/README.md +1 -1
- package/schemas/config.schema.json +44 -3
- package/schemas/tool-catalog.json +356 -3
- package/schemas/tools/add_dhcp_client.json +33 -0
- package/schemas/tools/force_cloud_update.json +7 -0
- package/schemas/tools/get_dhcp_client.json +13 -0
- package/schemas/tools/get_ip_cloud.json +7 -0
- package/schemas/tools/list_dhcp_clients.json +12 -0
- package/schemas/tools/remove_dhcp_client.json +12 -0
- package/schemas/tools/renew_dhcp_client.json +17 -0
- package/schemas/tools/set_dhcp_client.json +24 -0
- package/schemas/tools/set_ip_cloud.json +16 -0
- package/schemas/tools/set_ip_cloud_advanced.json +13 -0
- package/schemas/tools/test_ssh_from_device.json +28 -0
- package/schemas/tools/test_ssh_to_device.json +7 -0
- package/schemas/tools/test_ssh_to_host.json +38 -0
package/README.md
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<img src="assets/logo.svg" alt="@usex/mikrotik-mcp" width="440" />
|
|
3
|
-
<p><strong>A Bun-native MCP server that turns one or more MikroTik routers into
|
|
3
|
+
<p><strong>A Bun-native MCP server that turns one or more MikroTik routers into 706 tools your AI can drive.</strong><br/>
|
|
4
4
|
Firewall · routing · DHCP/DNS · wireless · QoS · and a complete VPN suite — over SSH, with transactional Safe Mode.</p>
|
|
5
5
|
|
|
6
6
|
<p>
|
|
7
7
|
<a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-7C3AED.svg"></a>
|
|
8
8
|
<img alt="Runtime: Bun" src="https://img.shields.io/badge/runtime-Bun%20%E2%89%A5%201.3-06B6D4.svg">
|
|
9
9
|
<img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-strict-6366F1.svg">
|
|
10
|
-
<img alt="MCP" src="https://img.shields.io/badge/MCP-
|
|
10
|
+
<img alt="MCP" src="https://img.shields.io/badge/MCP-706%20tools-1F2937.svg">
|
|
11
11
|
<a href="docs/"><img alt="Docs" src="https://img.shields.io/badge/docs-reference-7C3AED.svg"></a>
|
|
12
12
|
</p>
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
`@usex/mikrotik-mcp` exposes **MikroTik RouterOS** as **
|
|
18
|
-
tools across
|
|
17
|
+
`@usex/mikrotik-mcp` exposes **MikroTik RouterOS** as **706 [Model Context Protocol](https://modelcontextprotocol.io)
|
|
18
|
+
tools across 111 modules**, so an AI client (Claude Desktop, Claude Code, any MCP
|
|
19
19
|
client) can read and configure your router in plain language. It speaks to the
|
|
20
20
|
device over **SSH** — no agent, no API package to install on RouterOS — runs on
|
|
21
21
|
**[Bun](https://bun.sh)**, and validates every tool call against a Zod schema.
|
|
@@ -46,7 +46,7 @@ in memory and auto-reverts if your session drops, so you can't lock yourself out
|
|
|
46
46
|
|
|
47
47
|
## Why it's different
|
|
48
48
|
|
|
49
|
-
- 🧰 **Breadth** —
|
|
49
|
+
- 🧰 **Breadth** — 706 tools covering the whole device: L2 (bridge, VLAN, wireless,
|
|
50
50
|
PoE), L3 (addressing, routing, DHCP, DNS), security (firewall, NAT, address-lists,
|
|
51
51
|
certificates), QoS (queues), and system ops (users, logs, backups, scheduler).
|
|
52
52
|
- 🔐 **A complete VPN suite** — WireGuard, IPsec (IKEv1/IKEv2), L2TP, PPTP, SSTP,
|
|
@@ -87,7 +87,7 @@ mikrotik-mcp serve
|
|
|
87
87
|
against the server (from source):
|
|
88
88
|
|
|
89
89
|
```bash
|
|
90
|
-
bun run inspect # opens the Inspector UI to browse/run all
|
|
90
|
+
bun run inspect # opens the Inspector UI to browse/run all 706 tools
|
|
91
91
|
```
|
|
92
92
|
|
|
93
93
|
**Prefer SSH keys over a password?** Point the server at a key file instead — and
|
|
@@ -115,7 +115,7 @@ bun run build # bundle to dist/
|
|
|
115
115
|
|
|
116
116
|
## The tool catalog
|
|
117
117
|
|
|
118
|
-
**
|
|
118
|
+
**706 tools across 111 modules.** Full, always-current reference (parameters +
|
|
119
119
|
risk per tool) is generated from source: **[docs/tools-reference.md](docs/tools-reference.md)**.
|
|
120
120
|
|
|
121
121
|
| Group | Tools | Modules |
|