Installation

Zero-config (recommended)

npx -y @sylphx/citra

Agents and MCP hosts should prefer npx so users never install anything globally. Live package: @sylphx/citra@5.0.0.

Published stable

Install from npm. Current production is @sylphx/citra@5.0.0 — a sole-Rust MCP server launched by a thin Node entrypoint.

npm install -g @sylphx/citra
# or pin
npm install -g @sylphx/citra

What you get:

1. Thin launcher package
2. One platform native package as an optional dependency (auto-selected)

There is no TypeScript PDF runtime in the production package. If the matching native binary is missing, the server fails closed.

Requirements

• Node.js >= 22.13.0 (launcher only)
• Supported platforms:
  • macOS arm64 / x64
  • Linux x64 gnu / arm64 gnu
  • Windows x64
• Optional OCR / visual providers are opt-in (not required for core text paths)

Claude Code

claude mcp add citra -- npx @sylphx/citra

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "citra": {
      "command": "npx",
      "args": ["@sylphx/citra"]
    }
  }
}

Config file locations

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\\Claude\\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cursor / VS Code / Codex / other MCP clients

{
  "mcpServers": {
    "citra": {
      "command": "npx",
      "args": ["@sylphx/citra"]
    }
  }
}

Dual-era clients (Gemini Antigravity CLI)

Some MCP hosts probe with SEP-2575 server/discover before the legacy initialize handshake (for example Gemini Antigravity CLI on Windows). The native server answers that discovery request on stdio without closing the transport, then completes initialize as usual. If an older published build fails with expect initialized request / EOF on plugin load, upgrade to a release that includes this fix.

Run directly

npx @sylphx/citra
# or after global install
citra

HTTP transport:

MCP_TRANSPORT=http citra

Platforms

Platform	Native package
macOS arm64	@sylphx/citra-darwin-arm64
macOS x64	@sylphx/citra-darwin-x64
Linux x64	@sylphx/citra-linux-x64-gnu
Linux arm64	@sylphx/citra-linux-arm64-gnu
Windows x64	@sylphx/citra-win32-x64-msvc

Next

• Product proof — before/after, flagship workflows, performance bounds
• Getting started — tools and first calls
• Migration / recovery — historical notes only

Historical TypeScript baseline (not production)

Immutable external comparison/recovery pin only (transitional package id; not install CTA):

npm install -g @sylphx/pdf-reader-mcp@3.0.14

Production install CTA remains @sylphx/citra@5.0.0 only.