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 分