Iris

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

Iris — image facts with pixel-level proof. OCR runs only when requested.

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

概览

AI 生成的概览

Iris 是一个本地 MCP 服务器，让助手获得图像的实测事实——尺寸、格式、元数据、裁剪与像素差异，并可按需在本地执行 OCR。

可以做什么
读取单张本地图像，返回几何信息、元数据和可信度警告，可选裁剪区域，并可按需返回带边框和置信度的 OCR 文本行。探测图像格式、尺寸、像素数和源哈希，不执行 OCR 也不裁剪。裁剪指定区域，返回可引用的边界和哈希，仅在要求时返回 PNG 字节。比较两张同尺寸图像，报告变化的像素和变化区域。
适用场景
当助手需要对截图或其他本地图像给出可验证的事实而非猜测描述时使用：检查尺寸和格式、从图像中提取文字、引用特定区域，或找出两次截图之间的变化。
运行要求
作为本地 stdio 进程运行，通过 npx 从 npm 包启动，隐含需要 Node.js 和获取软件包的网络访问。无需 API 密钥。OCR 需要 PATH 中存在 tesseract 可执行文件；缺失时读取仍会成功，但会报告 OCR_UNAVAILABLE 缺口。
安装前请注意
它按路径读取本地图像文件，只应指向你愿意让助手看到的文件。OCR 在本地运行且仅在请求时执行。GPS 元数据字段始终被隐去且无法恢复。超过默认 32 MiB 上限或无法解码的文件会报错。README 说明该项目已归档并合并到另一工具，可能不再更新。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Iris，将其添加到工作区。
  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 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

4
  1. v0.4.1最新Sep 23, 2026
  2. v0.4.0Sep 23, 2026
  3. v0.3.3Sep 23, 2026
  4. v0.3.2Sep 23, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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