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 分