SylphxAI

Smart Reader MCP

Community SylphxAI
Updated

Prism — local media sniff + route for agents. One call reads PDF/image/video via sibling contracts with provenance. SDK · CLI · MCP.

Smart Reader MCP

One MCP call reads PDF, image, or video by sniffing format and delegating to Sylphx Reader siblings.

Status: v0.1.0 — read_media ships with format sniffing, sibling delegation, and provenance envelope.

Portfolio architecture (orchestration only): ADR-0002.

Repository Role
pdf-reader-mcp PDF (production)
image-reader-mcp Image
video-reader-mcp Video
smart-reader-mcp (this repo) Sniff format + delegate; phase 2 adds universal local/remote paths here

Read vs interpret

Read (this repo): extract facts, metadata, transcripts, regions, and timelines with provenance — no generative LLM required.

Interpret (out of scope): summarize, classify, or answer open questions — belongs in the agent or an optional remote provider adapter.

MCP surface (v0.1.0)

read_media

Reads a local file by sniffing magic bytes and extension, then delegates to the matching Sylphx Reader sibling MCP server.

Input

{
  "path": "/absolute/or/relative/path/to/media.pdf"
}

Supported formats

  • PDF: .pdf
  • Image: .png, .jpg, .jpeg, .gif, .webp, .tif, .tiff
  • Video: .mp4, .m4v, .mkv, .mov, .webm

Response envelope

Every successful call returns a normalized envelope with provenance:

{
  "source_path": "/path/to/media.pdf",
  "detected_format": "pdf",
  "delegated_tool": "read_pdf",
  "raw_result": {}
}
  • source_path — resolved absolute path that was read
  • detected_format — sniffed format (magic bytes first, extension fallback)
  • delegated_tool — sibling tool invoked (read_pdf, read_image, or read_video)
  • raw_result — passthrough result from the delegated reader

Delegation model

Smart Reader does not parse PDF/image/video itself. It spawns a stdio MCP client to the matching sibling package:

  1. Resolve a locally installed sibling (@sylphx/pdf-reader-mcp, etc.) via node <package-bin>
  2. Fall back to npx -y @sylphx/<reader>-mcp when the package is not installed locally
  3. Return an informative install hint if delegation fails

Install the readers you need:

npm install @sylphx/pdf-reader-mcp
npm install @sylphx/image-reader-mcp
npm install @sylphx/video-reader-mcp

Quick start

git clone https://github.com/SylphxAI/smart-reader-mcp.git
cd smart-reader-mcp
bun install
bun run build
npx @sylphx/smart-reader-mcp

MCP client config (stdio)

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

Development

bun install
bun run validate

License

MIT © SylphxAI

MCP Server · Populars

MCP Server · New

    kitfunso

    Hippo

    One memory for every agent you'll ever use. Hippo writes what you teach a coding agent into a store in your repo, and your other agents read that same store.

    Community kitfunso
    Avazbek22

    DevProjex: MCP / GUI / CLI / TUI all in one

    Repomix alternative with up to 40% fewer tokens. Turn any codebase or Git repository into safe, token-efficient context for LLM and coding agents like Claude Code, Codex, and Cursor. GUI, TUI, CLI, and a read-only RAG MCP server with Live Context, agent journal, Smart Ignore, secret/PII redaction, and code compression. Windows, macOS, Linux.

    Community Avazbek22
    membaseai

    Membase

    Memory layer for AI agents — SDKs, CLI and MCP server for Membase

    Community membaseai
    dosco

    DeepORG — One AI Agent for Your Whole Organization

    DeepORG (formerly GraphJin) — one AI agent for your whole organization: databases, APIs, files, and code over MCP

    Community dosco
    scumble-app

    Scumble

    Free, open-source desktop editor for AI inpainting: select, prompt, get a colour-matched layer. FLUX 3 Image, FLUX.2, GPT Image, Nano Banana, Seedream and Qwen through your API key or your own ComfyUI. Layers, PSD export, MCP.

    Community scumble-app