Skip to main content

Claude Swiss Army Knife — MCP Server Suite

Professional-grade MCP (Model Context Protocol) servers for managing your infrastructure through Claude Code. Give Claude safe, audited, and granular access to your Ubuntu servers, Obsidian vaults, Synology NAS devices, and GitHub — all from a single, permission-gated platform.

What This Is​

A suite of five integrated components running in Docker on your Ubuntu server:

ComponentTechPurpose
Ubuntu Server MCPPython 3.12Manage Ubuntu host: file I/O, commands, Docker, systemd
Obsidian MCPPython 3.12Read, write, and search your Obsidian vault notes
Synology NAS MCPPython 3.12Manage Synology NAS files and system via DSM 7.x API
GitHub MCPPython 3.12GitHub API access with tool-level permission gating
Permission Web UINext.js 15 / TypeScriptGraphical interface for managing all permissions
Shared Permission EnginePython (shared lib)Config-driven, default-deny, audit-logged access control

Architecture Overview​

┌──────────────┐ SSH + Cloudflare Tunnel ┌─────────────────────────────┐
│ Claude Code │ ───────────────────────────────▶ │ Ubuntu Server │
│ (your Mac) │ │ │
└──────────────┘ │ ┌───────────────────────┐ │
│ │ ubuntu-mcp │ │
│ │ (Python, stdio) │ │
│ └───────┬───────────────┘ │
│ │ │
│ ┌───────▼───────────────┐ │
│ │ Permission Engine │ │
│ │ (default-deny, audit) │ │
│ └───────────────────────┘ │
│ │
│ ┌───────────────────────┐ │
│ │ mcp-webui │ │
│ │ (port 8280) │ │
│ └───────────────────────┘ │
└─────────────────────────────┘

All MCP servers run in Docker containers and communicate over stdio — no network ports are exposed for MCP traffic. Claude Code connects via SSH (optionally over Cloudflare Tunnel) and pipes docker exec -i to talk to each container. The Web UI runs on port 8280 behind Cloudflare Tunnel with API key authentication.

Key Principles​

  • Default deny: Nothing is accessible unless explicitly granted. Every file path, shell command, and API tool must be allowlisted.
  • Granular permissions: Control read/write access per folder, per command pattern, and per tool — for each user.
  • Full audit trail: Every access decision (allow and deny) is logged with structured JSON, including timestamps, user IDs, and reasons.
  • Hot reload: Permission changes take effect in under 1 second. No restart needed.
  • Multi-user: Three access modes (open, allowlist, blocklist) with per-user tool restrictions and SHA-256 key authentication.

What You Can Do​

  • Manage servers: Read logs, edit configs, restart services, check system health — all through Claude Code conversations.
  • Work with notes: Search your Obsidian vault, create daily notes, find backlinks, organize by tags — without leaving your editor.
  • Handle NAS files: List, move, upload, and delete files on your Synology NAS through natural language requests.
  • Interact with GitHub: Search repos, read issues, create PRs — with tool-level restrictions preventing destructive actions.
  • Control access: Manage who can do what through a graphical Web UI, with instant updates and full visibility.

Quick Start​

# 1. Clone and configure
git clone git@github.com:Piero24/claude-swiss-army-knife.git
cd claude-swiss-army-knife
cp .env.example .env
# Edit .env with your server IPs, credentials, and paths

# 2. Generate API key for the Web UI
bash scripts/generate-api-key.sh

# 3. Start everything
docker compose up -d --build

# 4. Check health
bash scripts/health-check.sh

See the Installation guide for detailed step-by-step instructions.

Next Steps​

Requirements​

  • Docker + Docker Compose on an Ubuntu server
  • Python 3.12+ (in containers)
  • Node.js 22+ (in containers)
  • Cloudflare Tunnel (recommended for secure remote access)
  • Synology DSM 7.x with File Station API enabled (for NAS MCP)
  • GitHub personal access token (for GitHub MCP)

License​

MIT — see LICENSE for details.