Skip to main content
Glama
SylphxAI

smart-read-mcp

Official
by SylphxAI
README.md
# Smart Read MCP

> Universal read path for agents — local files and guarded remote URLs resolved into the Smart Reader stack.

**Status:** planned — repository scaffold; MCP tools not shipped yet.

Part of the [Sylphx Reader portfolio](https://github.com/SylphxAI/pdf-reader-mcp/blob/main/docs/adr/0004-reader-portfolio-architecture.md).

SOTA family roadmap: [docs/roadmap/sota-family-roadmap.md](docs/roadmap/sota-family-roadmap.md).

| Sibling | Role |
| --- | --- |
| [pdf-reader-mcp](https://github.com/SylphxAI/pdf-reader-mcp) | PDF Agent Document Twin (production) |
| [image-reader-mcp](https://github.com/SylphxAI/image-reader-mcp) | Image Agent Media Twin |
| [video-reader-mcp](https://github.com/SylphxAI/video-reader-mcp) | Video Agent Media Twin |
| [smart-reader-mcp](https://github.com/SylphxAI/smart-reader-mcp) | Format sniff + delegate |
| [smart-read-mcp](https://github.com/SylphxAI/smart-read-mcp) | Universal path (local + guarded URL) |
| [reader-evidence](https://github.com/SylphxAI/reader-evidence) | Shared evidence schema |

## 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.

## Planned MCP surface

Primary tool: `read_path`

## Quick start (after v0.1.0)

```bash
npx @sylphx/smart-read-mcp
```

## License

MIT © [SylphxAI](https://github.com/SylphxAI)

Maintenance

ActivityInactive
ResponsivenessNo issues