perch-mcp

The MCP server for building Perch mods. Point the AI tool you already use at it and it gets what only Perch can give it: the display vocabulary, the docs, the builtin packages as worked examples, a package validator, and a way to run your package in Perch.

Nothing here calls an AI. Your own client (Claude Code, Claude Desktop, Cursor, …) does the thinking on your own account.

Install

Requires Node 18+.

Claude Code

claude mcp add perch -- npx -y github:hlpdev/perch-mcp

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "perch": { "command": "npx", "args": ["-y", "github:hlpdev/perch-mcp"] }
  }
}

Cursor — .cursor/mcp.json (project) or the global one:

{
  "mcpServers": {
    "perch": { "command": "npx", "args": ["-y", "github:hlpdev/perch-mcp"] }
  }
}

Any other MCP client: run npx -y github:hlpdev/perch-mcp over stdio.

Related MCP server: Hanzo MCP

Tools

Try: "Make me a Perch widget that shows my Steam friends online, using the perch tools."

Updating the bundled content

content/ is generated from the Perch repos and committed:

npm run sync   # needs ../perch, ../perch-studio, ../perch-site checked out