mirror of
https://github.com/hansjone/netxops.git
synced 2026-10-19 19:13:20 +08:00
27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# Netx Ops tool map
|
|
|
|
Tools are discovered from netx **`/mcp`** (`tools/list`) and registered into DSH as `netx__<stem>`.
|
|
|
|
**One group ↔ one skill.** Group membership comes from `_meta.netx.group` on each MCP tool — there is no hardcoded catalog in the plugin. Skill markdown is pulled from MCP `resources` (`netx://skills/...`) into `$DSH_HOME/netxops-mcp-skills/` when the tool catalog refreshes.
|
|
|
|
| Group | Skill | Default in Ops preset |
|
|
|-------|-------|------------------------|
|
|
| **ops** | `netx-ops` | on |
|
|
| **topology** | `netx-topology` | off |
|
|
| **bizMonitor** | `netx-biz-monitor` | on |
|
|
|
|
## Visibility switches (UX only — not a security boundary)
|
|
|
|
- **Group inPreset / public** — register the whole group (or not).
|
|
- **`disabledTools`** — opt-out list of **server** tool names; unlisted tools follow the group.
|
|
- **`readOnlyOnly`** — drop tools whose `annotations.readOnlyHint` is not `true`.
|
|
|
|
Authorization, CLI show/display guards, and RBAC stay on the netx `/mcp` server.
|
|
|
|
## Forced mounts
|
|
|
|
`dsh-netxops/tools-ops` | `tools-topology` | `tools-biz-monitor` (legacy aliases: `tools-nms` / `tools-common` → ops).
|
|
|
|
## Offline
|
|
|
|
When `/mcp` is unreachable, the Plugins card shows the last cached tools/list and a disconnected hint. Registration uses that in-memory tool cache so toggles still work until connect recovers. Skill files stay on disk from the last successful resources pull and are still registered after a plugin restart.
|