io.github.puglieseweb/systemdox-runbooks

Official

by puglieseweb

Your runbooks as agent tools: scripts from runbooks.json served as typed, allowlisted MCP tools.

io.github.puglieseweb/systemdox-runbooks (MCP Server)

This MCP server exposes your runbooks as agent tools. It serves scripts defined in runbooks.json as typed, allowlisted MCP tools, enabling controlled execution of runbook tasks through the MCP interface.

🛠️ Key Features

Runs scripts sourced from runbooks.json
Exposes runbook scripts as typed MCP tools
Tool access is allowlisted

🚀 Use Cases

Use runbooks as callable tools for agents
Execute predefined operational scripts via an allowlist

⚡ Developer Benefits

Typed tool interfaces derived from runbook definitions
Predictable tool availability via allowlisting

⚠️ Limitations

Tool content and availability are limited to what is provided in runbooks.json

Install

Configuration

Environment variables

RUNBOOK_MCP_MANIFEST

Path to the runbooks.json manifest (alternative to the --manifest argument). Defaults to ./runbooks.json.

RUNBOOK_MCP_DRY_RUN

Set to 1 to have every tool report the command it would run instead of running it.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "systemdox-runbooks": {
      "command": "npx",
      "args": [
        "-y",
        "@systemdox/runbook-mcp@0.1.3"
      ],
      "env": {
        "RUNBOOK_MCP_MANIFEST": "<YOUR_RUNBOOK_MCP_MANIFEST>",
        "RUNBOOK_MCP_DRY_RUN": "<YOUR_RUNBOOK_MCP_DRY_RUN>"
      }
    }
  }
}