Installation

Requirements

• Node.js >= 22.0.0

Claude Code

claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pdf-reader": {
      "command": "npx",
      "args": ["@sylphx/pdf-reader-mcp"]
    }
  }
}

Config file locations:

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

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "pdf-reader": {
      "command": "npx",
      "args": ["@sylphx/pdf-reader-mcp"]
    }
  }
}

Other MCP Clients

The server communicates via stdio. Run with:

npx @sylphx/pdf-reader-mcp

Development Setup

1. Clone the repository:

   git clone https://github.com/SylphxAI/pdf-reader-mcp.git
   cd pdf-reader-mcp

2. Install dependencies:

   bun install

3. Build:

   bun run build

4. Run:

   bun dist/index.js

Troubleshooting

Cache Issues

If you encounter issues after updating, clear the npm cache:

npm cache clean --force
rm -rf ~/.npm/_npx

Then restart your MCP client.