Skip to content

Commit 4706c14

Browse files
muchinyclaude
andcommitted
docs: sync tool counts to 357/75/9 + drop phantom protocols
- CLAUDE.md, plugin/README.md, server.json, specs/001-*/plan.md: align with actual registry — 357 tools, 75 groups, 60 Linux groups. - plugin/README.md: drop fabricated protocols (ZeroMQ, NATS, MQTT, SNMP, NETCONF — never implemented). Real list: 9 (SSH, WinRM, PSRP, Telnet, K8s Exec, Serial, AWS SSM, Azure, GCP). - src/mcp/tool_handlers/ssh_files_write.rs: replace prod unreachable!() with BridgeError::McpInvalidRequest for defense in depth if upstream validation drifts. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent b1be378 commit 4706c14

5 files changed

Lines changed: 15 additions & 13 deletions

File tree

‎CLAUDE.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
## Project Overview
44

5-
MCP SSH Bridge is a Rust MCP server that enables Claude Code to securely execute commands on air-gapped environments via SSH. JSON-RPC over stdio, strict security controls. **338 tools** across **74 groups** (59 Linux, 13 Windows, 2 cross-platform).
5+
MCP SSH Bridge is a Rust MCP server that enables Claude Code to securely execute commands on air-gapped environments via SSH. JSON-RPC over stdio, strict security controls. **357 tools** across **75 groups** (60 Linux, 13 Windows, 2 cross-platform).
66

77
## CLI-as-Tool Mode (Alternative to MCP)
88

9-
All 338 MCP tools are accessible directly via CLI, enabling **10-32x token savings** compared to MCP mode. Use CLI for dev workflows, MCP for enterprise integration.
9+
All 357 MCP tools are accessible directly via CLI, enabling **10-32x token savings** compared to MCP mode. Use CLI for dev workflows, MCP for enterprise integration.
1010

1111
### Quick Reference
1212

@@ -17,7 +17,7 @@ mcp-ssh-bridge tool ssh_exec host=prod command="df -h" --json
1717
mcp-ssh-bridge tool ssh_k8s_get --json-args '{"host":"k8s","resource":"pods","namespace":"default"}'
1818

1919
# Progressive discovery (token-efficient for AI agents)
20-
mcp-ssh-bridge list-tools --groups-only # 74 groups (~2K tokens)
20+
mcp-ssh-bridge list-tools --groups-only # 75 groups (~2K tokens)
2121
mcp-ssh-bridge list-tools --group docker # tools in group (~500 tokens)
2222
mcp-ssh-bridge list-tools --search kubernetes # keyword search
2323
mcp-ssh-bridge describe-tool ssh_docker_ps # full schema + Reduction Strategy (~200 tokens)
@@ -136,7 +136,7 @@ dxt/ # DXT packaging (Claude Desktop extension)
136136

137137
## Tool Groups Reference
138138

139-
74 groups, 338 tools (59 Linux, 13 Windows, 2 cross-platform). Full reference loaded automatically when editing registry or handlers (see `.claude/rules/tool-groups-reference.md`). Quick overview: `mcp-ssh-bridge list-tools --groups-only`.
139+
75 groups, 357 tools (60 Linux, 13 Windows, 2 cross-platform). Full reference loaded automatically when editing registry or handlers (see `.claude/rules/tool-groups-reference.md`). Quick overview: `mcp-ssh-bridge list-tools --groups-only`.
140140

141141
## Feature Flags
142142

@@ -192,7 +192,7 @@ Detailed guidance is loaded automatically via `.claude/rules/`:
192192
- `mcp-protocol.md` — JSON-RPC, McpServer, protocol versioning
193193
- `ports.md` — Traits, mock patterns, ToolContext, ExecutorRouter
194194
- `cli.md` — Clap derive, global flags, runner pattern, exit codes
195-
- `tool-groups-reference.md` — Full 74-group tool reference table
195+
- `tool-groups-reference.md` — Full 75-group tool reference table
196196

197197
## Active Technologies
198198

‎plugin/README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# MCP SSH Bridge -- Claude Code Plugin
22

3-
This plugin integrates [mcp-ssh-bridge](https://github.com/muchiny/mcp-ssh-bridge) into Claude Code, giving you access to **338 tools** for managing remote servers via SSH.
3+
This plugin integrates [mcp-ssh-bridge](https://github.com/muchiny/mcp-ssh-bridge) into Claude Code, giving you access to **357 tools** for managing remote servers via SSH.
44

55
## Prerequisites
66

@@ -27,21 +27,21 @@ hosts:
2727
2828
### MCP Server
2929
30-
The plugin registers `mcp-ssh-bridge` as an MCP server, exposing all 338 tools
30+
The plugin registers `mcp-ssh-bridge` as an MCP server, exposing all 357 tools
3131
directly to Claude Code for remote server management.
3232

3333
### Skills
3434

3535
| Skill | Description |
3636
|-------|-------------|
3737
| `/mcp-ssh-bridge:bridge` | Manage remote hosts -- status, config, tool execution |
38-
| `/mcp-ssh-bridge:discover` | Explore 338 tools across 74 groups with progressive discovery |
38+
| `/mcp-ssh-bridge:discover` | Explore 357 tools across 75 groups with progressive discovery |
3939

4040
### Capabilities
4141

42-
- **Linux** (59 groups): systemd, Docker, Kubernetes, networking, filesystems, logs, packages, users, cron, firewall, etc.
42+
- **Linux** (60 groups): systemd, Docker, Kubernetes, networking, filesystems, logs, packages, users, cron, firewall, etc.
4343
- **Windows** (13 groups): PowerShell, services, registry, IIS, Active Directory, EventLog, etc.
44-
- **13 protocols**: SSH, WinRM, Telnet, K8s Exec, Serial, AWS SSM, Azure, GCP, ZeroMQ, NATS, MQTT, SNMP, NETCONF
44+
- **9 protocols**: SSH, WinRM, PSRP, Telnet, K8s Exec, Serial, AWS SSM, Azure, GCP
4545
- **Token-efficient**: server-side output filtering (jq/yq, columns, limit, pagination)
4646
- **Secure**: command validation, input sanitization, rate limiting, audit logging
4747

‎server.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"$schema": "https://registry.modelcontextprotocol.io/schemas/server.json",
33
"name": "io.github.muchiny/mcp-ssh-bridge",
44
"version": "1.14.0",
5-
"description": "Secure SSH bridge for AI-powered remote server management. 338 tools across 74 groups for Linux, Windows, Docker, Kubernetes, and more.",
5+
"description": "Secure SSH bridge for AI-powered remote server management. 357 tools across 75 groups for Linux, Windows, Docker, Kubernetes, and more.",
66
"repository": {
77
"url": "https://github.com/muchiny/mcp-ssh-bridge",
88
"source": "github"

‎specs/001-winrm-psrp-integration/plan.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ the fundamental bug where 44 Windows handlers generate PowerShell but WinRM send
2121
**Project Type**: CLI + MCP server (library + binary)
2222
**Performance Goals**: Connection pooling amortizes TLS/auth overhead; sub-100ms warm calls
2323
**Constraints**: 24GB WSL2 VM (OOM-prone), air-gapped deployments, `#![forbid(unsafe_code)]`
24-
**Scale/Scope**: 338 tools, 74 groups, 13 protocols, 44 Windows handlers affected
24+
**Scale/Scope**: 357 tools, 75 groups, 9 protocols, 44 Windows handlers affected
2525

2626
### Key Version Concern
2727

‎src/mcp/tool_handlers/ssh_files_write.rs‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,9 @@ impl ToolHandler for SshFilesWriteHandler {
249249
)
250250
.await
251251
} else {
252-
unreachable!("validated above");
252+
return Err(BridgeError::McpInvalidRequest(format!(
253+
"files[{i}]: missing both 'content' and 'local_path' (validation invariant violated)"
254+
)));
253255
};
254256

255257
let action = if entry.content.is_some() {

0 commit comments

Comments
 (0)