Skip to content
MCP server

Phonebook

Turns SwiftUI #Preview and Jetpack Compose @Preview screens into a static HTML gallery

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, iOS
Runs
Locally
Version
0.1.13
Listing updated
2 days ago

About Phonebook

Phonebook is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Phonebook is pitched as a self-hosted, open-source alternative to Emerge Tools Snapshots. Instead of writing new test code, it harvests the previews your team already has and renders them into a Storybook-style gallery that designers can open without installing anything. Cards are grouped as component and state, inferred from preview names with no extra annotation.

The flow has two steps. phonebook generate runs the platform's preview renderer and writes a bundle with a manifest.json and images; on Android it uses Roborazzi and ComposablePreviewScanner on the JVM with no emulator, and on iOS it uses SnapshotPreviews through xcodebuild on a simulator, which needs macOS. phonebook build then makes plain HTML, CSS and JS that works from file:// or any static host. Each repo runs independently and, in version one, handles a single platform.

The MCP server is the recommended way in: a coding agent can check setup, analyse preview coverage, add missing previews and build the gallery. Init and doctor commands resolve library versions against the project's Kotlin version to catch metadata mismatches early.

Install

Run in a terminal

claude mcp add phonebook -- npx -y @stag-build/phonebook

Add to claude_desktop_config.json

{
  "mcpServers": {
    "phonebook": {
      "command": "npx",
      "args": [
        "-y",
        "@stag-build/phonebook"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "phonebook": {
      "command": "npx",
      "args": [
        "-y",
        "@stag-build/phonebook"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "phonebook": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@stag-build/phonebook"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "phonebook": {
      "command": "npx",
      "args": [
        "-y",
        "@stag-build/phonebook"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "phonebook": {
      "command": "npx",
      "args": [
        "-y",
        "@stag-build/phonebook"
      ]
    }
  }
}

What it does

Reuses existing previews
Harvests @Preview and #Preview code with no new test code.
Static HTML gallery
Output works from file:// or any static host, with no SaaS account.
Agent-driven setup
The MCP server lets an agent check setup, find missing previews and build the site.
Component and state cards
Groups previews by names without needing annotations.
Android on the JVM
Roborazzi and Robolectric render previews without an emulator.
Version-aware init
init and doctor align library versions with the project's Kotlin version.

Good for

  • Publish a component gallery for designers from an Android repo
  • Review iOS SwiftUI preview states without opening Xcode
  • Find components that lack previews
  • Generate the gallery in CI
  • Let a coding agent set up preview rendering

Pricing

Open source

Free, open source, self-hosted

Prices change. Check stag-build.github.io before you buy.

Phonebook FAQ

Do I need a SaaS account?

No. It is self-hosted and runs locally or in your CI.

Can one repo cover both platforms?

Not in v1; one Android or iOS repo produces one bundle and one site.

What does iOS need?

macOS, since previews render with xcodebuild on a simulator.

How do I start the MCP server?

Run npx -y @stag-build/phonebook mcp, for example via claude mcp add phonebook.

How can I install the CLI?

npm install -g @stag-build/phonebook or Homebrew.

Is Phonebook free?

Yes. Phonebook is open source, so you can use and self-host it for free.

How do I add Phonebook to Claude Code?

Run this command in your terminal: claude mcp add phonebook -- npx -y @stag-build/phonebook

What are the best alternatives to Phonebook?

The closest alternatives to Phonebook are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to Phonebook

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory