Image Reader MCP

io.github.SylphxAI由 GitHub 账号 SylphxAI 发布v0.1.0更新于 Oct 24, 2026

Evidence-first image MCP. Agent Media Twin with metadata and citeable OCR evidence.

已验证STDIO仅桌面文件与存储媒体与设计

概览

AI 生成的概览

本地 stdio MCP 服务器，为助手提供可核验的图片事实：尺寸、格式、元数据、裁剪与差异，并可按需调用本地 Tesseract OCR。

可以做什么
  • 读取单张本地图片，返回尺寸、格式、元数据与可信度提示，可选区域裁剪与 OCR。
  • 探测图片的格式、尺寸、像素数与源文件哈希，不做 OCR 也不裁剪。
  • 裁剪指定区域并返回可引用的像素边界与哈希，可选返回 PNG 字节。
  • 比较两张同尺寸图片，报告变化的像素与变化区域。
  • 仅在明确请求时返回带文本、边界框与置信度的 OCR 行。
适用场景
适合需要可核验图片信息的场景，例如确认截图尺寸、提取带坐标的 OCR 文本，或对比同一界面的两次截图，而不是让模型凭猜测描述图片。
运行要求
以 stdio 在本地运行，通常通过 npx 使用已发布的 npm 包，首次获取需要 Node.js 与网络。无需 API 密钥。OCR 需要 PATH 中存在 tesseract 可执行文件；缺失时读取仍成功，但会报告 OCR 缺口。
安装前请注意
它按路径读取本地图片文件，助手可访问被给出的任意图片路径。OCR 在本地运行，不使用生成式视觉模型。GPS 元数据始终被抹除且无法恢复。超过默认 32 MiB 上限或无法解码的文件会报错。README 说明该仓库已归档并合并进另一个包。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Image Reader MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Merged into anymd (2026-09-25). anymd reads PDFs, Office files, EPUB, web pages, images and video into clean Markdown for AI agents: npx -y @sylphx/anymd. This repository is archived.

[Iris]

Iris

Image facts with pixel-level proof.

Dimensions, format, and metadata by default. Local Tesseract OCR only when requested.

[npm] [license]

npm @sylphx/iris · bin iris · MCP io.github.SylphxAI/iris

The problem

A screenshot is not a paragraph. An agent that guesses the text, the size, or the pixels it never measured will cite something it cannot show.

The difference

The askIris returns
“Read this screenshot.”dimensions, format, metadata, and trust warnings. No OCR unless you ask.
“Read the text.”OCR lines with boxes, only when include_ocr is true or profile is quality.
“What changed between these two captures?”changed pixels and a changed box, when both images are the same size.
“Crop this region.”pixel bounds and a hash. PNG bytes only if include_region_image is true.

Iris does not run a generative vision model. A missing Tesseract binary is a gap, not a made-up transcription.

Install

bash
npx -y @sylphx/iris

That starts a stdio MCP server. No API key. OCR needs the tesseract binary on PATH.

Your clientSetup
Any agent / CLInpx -y @sylphx/iris
Claude Codeclaude mcp add iris -- npx -y @sylphx/iris
Claude Desktop / Cursor / VS Code / Codex"command": "npx", "args": ["-y", "@sylphx/iris"]
json
{  "mcpServers": {    "iris": { "command": "npx", "args": ["-y", "@sylphx/iris"] }  }}

A read, then text only if you ask

json
{ "path": "/absolute/path/to/screenshot.png" }

fast, or no profile, returns dimensions, format, metadata, and trust warnings. It does not run OCR.

json
{  "path": "/absolute/path/to/screenshot.png",  "include_ocr": true}

include_ocr: true, or profile: "quality", runs local Tesseract. Explicit include_ocr: false wins over quality. If Tesseract is missing, status stays ok and gaps includes OCR_UNAVAILABLE.

Reference: tools · defaults

Tools

ToolWhen to call it
read_imageOne local image. Geometry and metadata. OCR only when requested. An optional region crops inside this read.
image_probeFormat, dimensions, pixel count, and source hash. No OCR and no crop.
crop_regionOne citeable region: bounds and hash. Set include_region_image for PNG bytes. No OCR.
compare_imagesChanged pixels between two images of equal dimensions. No OCR.

What it will not pretend

  • GPS fields are always redacted. There is no switch that puts them back.
  • The default file cap is 32 MiB (33,554,432 bytes). A cropped region may not exceed 67,108,864 pixels.
  • compare_images requires equal dimensions. It does not resize either image.
  • OCR lines are {text, bbox, confidence}. The default language is eng.
  • Oversized or undecodable files fail with an error. They are not returned as a successful read.

Companion MCP tools

ProductJob
CitraPDF answers with page-level proof
CueVideo timelines and timestamp evidence
SpineRepository architecture and impact
LocusExact code-chunk retrieval
LookoutWeb research with source excerpts

Each product is independent. Install only the tools your agent needs.

Documentation

Websitesylphxai.github.io/iris
QuickstartInstall and first call
CompareWhat Iris does, and what it refuses

Development

bash
bun installbun testbun run checkbun run docs:buildcargo test

License

MIT

来源：README.md，提交 90fb41a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分