mikromcp 1.5.0 โ†’ 1.6.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.
Files changed (3) hide show
  1. package/README.md +9 -2
  2. package/dist/main.js +1219 -1263
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -12,7 +12,7 @@
12
12
 
13
13
  [![CI](https://github.com/AliKarami/MikroMCP/actions/workflows/ci.yml/badge.svg)](https://github.com/AliKarami/MikroMCP/actions/workflows/ci.yml)
14
14
  [![Release](https://github.com/AliKarami/MikroMCP/actions/workflows/release.yml/badge.svg)](https://github.com/AliKarami/MikroMCP/actions/workflows/release.yml)
15
- [![Version](https://img.shields.io/badge/version-v1.5.0-EA580C)](package.json)
15
+ [![Version](https://img.shields.io/badge/version-v1.6.0-EA580C)](package.json)
16
16
  [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
17
17
  [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-339933)](package.json)
18
18
  [![RouterOS 7.x](https://img.shields.io/badge/RouterOS-7.x-293239)](https://help.mikrotik.com/docs/display/ROS/REST+API)
@@ -52,7 +52,7 @@ MikroMCP exists because raw router CLI access is the wrong abstraction for AI ag
52
52
  | ๐Ÿงช **Diagnostics** | Router-originated `ping`, `traceroute`, `torch`, log filtering, guarded SSH command execution |
53
53
  | ๐Ÿ›ก๏ธ **Change safety** | Dry-run, idempotent writes, snapshots, write journal, `plan_changes`, `apply_plan`, `rollback_change` |
54
54
  | โš™๏ธ **Production behavior** | Retries for read tools, per-router circuit breakers, correlation IDs, structured logs, audit logs |
55
- | ๐Ÿค– **AI-agent fit** | Human-readable responses plus structured JSON content for reasoning, chaining, and automation |
55
+ | ๐Ÿค– **AI-agent fit** | Human-readable responses plus structured JSON content for reasoning, chaining, and automation; server advertises an `instructions` string on MCP initialize so clients self-configure; optional [`routerId` resolved via `MIKROMCP_DEFAULT_ROUTER`](#configuration-reference) for single-router setups; [usage skill](docs/wiki/Using-the-Skill.md) for safe, guided tool use in Claude Code |
56
56
  | ๐Ÿงฉ **MCP compatibility** | stdio for desktop clients, Streamable HTTP and legacy SSE for remote or service-style clients |
57
57
 
58
58
  ---
@@ -265,6 +265,7 @@ All settings can be placed in `~/.mikromcp/.env` or passed as environment variab
265
265
  | --------------------------------- | -------------------------------- | ------------------------------------------------------ |
266
266
  | `MIKROMCP_TRANSPORT` | `stdio` | `stdio` or `http` |
267
267
  | `MIKROMCP_CONFIG_PATH` | `~/.mikromcp/routers.yaml` | Router registry path |
268
+ | `MIKROMCP_DEFAULT_ROUTER` | unset | Router ID used when a tool call omits `routerId`; falls back to the sole configured router if only one exists |
268
269
  | `MIKROMCP_IDENTITIES_PATH` | `~/.mikromcp/identities.yaml` | Identity and bearer-token registry |
269
270
  | `MIKROMCP_STDIO_IDENTITY` | built-in superadmin | Named identity for stdio mode |
270
271
  | `MIKROMCP_PORT` | `3000` | HTTP transport port |
@@ -423,6 +424,7 @@ AI assistants can use MikroMCP to:
423
424
  | [Configuration](https://github.com/AliKarami/MikroMCP/wiki/Configuration) | Router registry, credentials, all environment variables |
424
425
  | [Connecting to Claude Desktop](https://github.com/AliKarami/MikroMCP/wiki/Connecting-to-Claude-Desktop) | Register MikroMCP in Claude Desktop |
425
426
  | [Connecting to AI Assistants](https://github.com/AliKarami/MikroMCP/wiki/Connecting-to-AI-Assistants) | Claude Code, Cursor, Codex, HTTP/Docker/systemd |
427
+ | [Using the Skill](docs/wiki/Using-the-Skill.md) | Install the MikroMCP usage skill so your AI assistant drives the tools safely. |
426
428
  | [Available Tools](https://github.com/AliKarami/MikroMCP/wiki/Available-Tools) | All 117 tools โ€” parameters and example prompts |
427
429
  | [Architecture](https://github.com/AliKarami/MikroMCP/wiki/Architecture) | System layers, request pipeline, auth model |
428
430
  | [Error Handling](https://github.com/AliKarami/MikroMCP/wiki/Error-Handling) | Error categories, retry engine, circuit breaker |
@@ -469,6 +471,11 @@ Key project paths:
469
471
  | v0.8 | โœ… Shipped | Snapshots, write journal, plan/apply, rollback, maintenance windows |
470
472
  | v0.9 | โœ… Shipped | Fleet operations, IPSec, certificates, users, DHCP servers/pools, queues/QoS, VRRP, SNMP/NTP, Netwatch, discovery, ARP, health checks |
471
473
  | v1.0 | โœ… Shipped | npm package, standalone binaries, Docker images, `mikromcp init` wizard, `mikromcp doctor`, `~/.mikromcp/` convention |
474
+ | v1.1 | โœ… Shipped | Correctness, security hardening, orchestration: retry/circuit-breaker fixes, audit redaction, Prometheus metrics, fleet-confirmed `bulk_execute` |
475
+ | v1.2 | โœ… Shipped | DHCP & interface completeness: `manage_vlan`, `list/manage_ip_pool`, `manage_dhcp_lease`, DHCP clients, IP services |
476
+ | v1.3 | โœ… Shipped | PPPoE & OpenVPN: `list/manage_pppoe_client`, `list/manage_ovpn_client`, `get/manage_ovpn_server` |
477
+ | v1.4 | โœ… Shipped | System administration depth: user groups, firmware upgrade, config backup/export, log rule management, NTP write |
478
+ | v1.5 | โœ… Shipped | Container depth & diagnostics: container config/env/mount tools, `bandwidth_test` (99 โ†’ 117 tools) |
472
479
 
473
480
  See [ROADMAP.md](ROADMAP.md) for the complete milestone plan.
474
481