Puppet Master MCP Server

MCP (Model Context Protocol) server providing 26 tools for Puppet Master framework operations — initialization, development, database, deployment, builds, linting, testing, configuration, knowledge retrieval, contribution workflows, and code reviews.

Quick Start

git clone <repo-url> pm-mcp-server
cd pm-mcp-server
npm install

Global Registration (Kilo)

Add to ~/.config/kilo/kilo.json:

{
  "mcp": {
    "puppetmaster": {
      "type": "local",
      "command": ["node", "/path/to/pm-mcp-server/dist/index.js"],
      "enabled": true
    }
  }
}

Or use tsx to run from source (enables dynamic TS config imports):

"command": ["npx", "tsx", "/path/to/pm-mcp-server/src/index.ts"]

Local Registration (Project)

Add to .kilo/kilo.json in a project:

{
  "mcp": {
    "puppetmaster": {
      "type": "local",
      "command": ["node", "../pm-mcp-server/dist/index.js"],
      "enabled": true
    }
  }
}

Related MCP server: Magento 2 Development MCP Server

Tools (26)

How It Works

The server uses process.cwd() to detect the current PM project root (set automatically by the host agent). Each tool operates on the project in the current working directory. From a non-PM directory, tools report "no config found" gracefully.

Build

npm run build    # TypeScript → dist/

Pre-built dist/ is committed for users who want to run with node directly without tsx.

License

MIT