jakub's mcp tools

MCP server + web dashboard for infrastructure discovery and remote management. Exposes tools to AI agents via the Model Context Protocol for SSH command execution, file transfer, log tailing, and machine/service inventory. A companion web UI provides a browser-based dashboard for the same data.

All components — the MCP server, REST API, and dashboard — share a single SQLite database. Machines and services registered in the web UI are immediately available to the MCP tools, and commands the agent executes appear in the dashboard's activity feed.

Docker

docker compose up -d
# → Dashboard: http://localhost:8082

The database is persisted in ./data on the host. Configure your MCP client:

{
  "mcpServers": {
    "jakubs-mcp-tools": {
      "command": "docker",
      "args": ["compose", "run", "--rm", "mcp"]
    }
  }
}

Related MCP server: acp-mcp

Running Without Docker

# Clone and install
git clone <repo-url>
cd mcp-tools
cp .env.example .env
npm install

# Build
npm run build

# Start the dashboard + API
npm run dev:all
# → UI:  http://localhost:8081
# → API: http://localhost:8082

# Run the MCP server directly
npm run dev

Configuration

Features

MCP Tools (for AI agents)

• Command allowlisting — SSH commands are validated against a configurable allowlist. Set ALLOWLIST_ENABLED=false in .env to allow any command without restriction.

• Audit trail — every SSH command and SCP transfer is logged with exit code, output, and timestamp.

• Key-based auth — all SSH connections use registered private keys (no passwords).

Web Dashboard

• Dashboard — aggregate stats, recent activity feed, most-active machines

• Machines — table with search, pagination, CRUD modal (hostname, OS, IP, SSH user)

• Services — table with search, machine filter, pagination, CRUD modal (name, URL, port, type, notes)

• Logs — full audit trail with search, machine/status filters, detail view with command output

• Dark theme, responsive (mobile sidebar drawer)

CLI Usage

Each module can be run standalone for testing:

# Query machines
node dist/get_machines.js --all
node dist/get_machines.js --id 1

# Execute a command
node dist/execute_ssh.js --id 1 --cmd "docker ps"

# Transfer a file
node dist/scp.js -i 1 -d to -r /tmp/out.txt -l ./local.txt

# Tail logs
node dist/tail_logs.js -i 1 -p /var/log/syslog -n 100

# Add a machine
node dist/add_entries.js add-machine --hostname web-01 --ip 10.0.0.1 --username root --key ~/.ssh/id_rsa

# Add a service
node dist/add_entries.js add-service --machine-id 1 --name nginx --port 80 --type "Web hosting"

npm Scripts

License

MIT