Connect Philly

Node 24+

Install

git clone https://github.com/h0rv/philly.git
cd philly/mcp
npm ci

Stdio

Replace /absolute/path/to/philly with your checkout’s path.

Claude Code

claude mcp add philly -- node --experimental-strip-types /absolute/path/to/philly/mcp/src/stdio.ts

Desktop clients

{
  "mcpServers": {
    "philly": {
      "command": "node",
      "args": [
        "--experimental-strip-types",
        "/absolute/path/to/philly/mcp/src/stdio.ts"
      ]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "philly": {
      "type": "stdio",
      "command": "node",
      "args": [
        "--experimental-strip-types",
        "/absolute/path/to/philly/mcp/src/stdio.ts"
      ]
    }
  }
}

Local HTTP

Bun 1.3.11 · from the repository root · includes the website.

cd website
bun install --frozen-lockfile
bun run build
cd ../mcp
npm ci
npm run dev

http://127.0.0.1:8787/mcp

For clients on your computer. Cloud-hosted assistants cannot reach localhost.

Remote MCP

Your deployed endpoint in .vscode/mcp.json:

{
  "servers": {
    "philly": {
      "type": "http",
      "url": "https://your-worker.example/mcp"
    }
  }
}

MCP tools and limits