🇨🇳 한국어

ocrtool-mcp는 Swift와 Vision Framework를 내장한 오픈 소스 macOS-native OCR MCP 서버입니다. Claude Desktop, Cursor, Continue, Windsurf, Cline, Cherry Studio, 또는 stdin에서 JSON-RPC를 사용하는 사용자 정의 에이전트와 같은 도구의 로컬 stdio 통합을 위해 설계되었습니다.

---

✨ 특징

• ✅ macOS Vision Framework에 의해 구동되는 정확한 OCR
• ✅ 중국어와 영어 텍스트 모두 인식
• ✅ initialize, tools/list], tools/call를 가진 표준 MCP 수명주기
• ✅ 번들 ocr-workflow] MCP를 통해 기술을 선호하는 에이전트 플랫폼에 대한 기술
• ✅ Line-wise OCR 결과 (픽셀에서)
• ✅ 다중 이미지 입력 방법 (현지 경로, URL, Base64)
• ✅ 유연한 출력 형식 (문서, Markdown 테이블, JSON, 코드 의견)
• ✅ 경량, 빠르고, 완전 오프라인
• ✅ 오픈 소스 무료 소프트웨어

---

☸ 임명

어느 것을 사용해야합니까?

대부분의 사용자를 위해, 선택은 간단합니다:

• 에이전트 플랫폼이 기술을 지원하고 더 많은 가이드, 자연적인 언어 워크플로우를 원할 때 ** 번들링 기술**을 사용하십시오.
• 에이전트 플랫폼이 MCP 서버를 지원할 때 ** MCP**를 사용하십시오.

ocrtool-mcp

🇨🇳 中文文档

ocrtool-mcp is an open-source macOS-native OCR MCP server built with Swift and the Vision framework. It is designed for local stdio integrations in tools like Claude Desktop, Cursor, Continue, Windsurf, Cline, Cherry Studio, or custom agents using JSON-RPC over stdin.

---

✨ Features

• ✅ Accurate OCR powered by macOS Vision Framework
• ✅ Recognizes both Chinese and English text
• ✅ Standard MCP lifecycle with initialize, tools/list, and tools/call
• ✅ Bundled ocr-workflow skill for agent platforms that prefer skills over raw MCP
• ✅ Returns line-wise OCR results with bounding boxes (in pixels)
• ✅ Multiple image input methods (local path, URL, Base64)
• ✅ Flexible output formats (plain text, Markdown table, JSON, code comments)
• ✅ Lightweight, fast, and fully offline
• ✅ Open source free software

---

📦 Installation

Which One Should You Use?

For most users, the choice is simple:

• Use the bundled skill when your agent platform supports skills and you want a more guided, natural-language workflow.
• Use MCP when your agent platform supports MCP servers and you want ocrtool-mcp exposed as a standard tool.

In practical terms:

• Codex / Claude with skills support: install the skill first
• Claude Desktop / Cursor / Continue / Windsurf / Cline / Cherry Studio: connect the MCP server
• Not sure: start with the skill if your platform has a skills directory; otherwise use MCP

Method 1: Using Homebrew (Easiest)

Homebrew availability follows the release pipeline: install or upgrade with Homebrew after the GitHub Actions release workflow finishes and syncs Formula/ocrtool-mcp.rb.

brew tap ihugang/ocrtool
brew install ocrtool-mcp

Ready to use after installation:

ocrtool-mcp --help

Method 2: Download Pre-built Binary

Download the pre-compiled Universal Binary that supports all Macs (Intel and Apple Silicon):

VERSION=""
curl -L -O "https://github.com/ihugang/ocrtool-mcp/releases/download/v${VERSION}/ocrtool-mcp-v${VERSION}-universal-macos.tar.gz"

# Extract
tar -xzf "ocrtool-mcp-v${VERSION}-universal-macos.tar.gz"

# Make executable
chmod +x "ocrtool-mcp-v${VERSION}-universal"

# Move to system path (recommended)
sudo mv "ocrtool-mcp-v${VERSION}-universal" /usr/local/bin/ocrtool-mcp

# Verify installation
ocrtool-mcp --help

Alternatively, you can download directly from the GitHub Releases page.

Method 3: Build from Source

If you prefer to build from source or contribute to development:

git clone https://github.com/ihugang/ocrtool-mcp.git
cd ocrtool-mcp