Official description7 sourcesMCP servers8d ago

juergenkoller-software/freezetext-mcp

Open-source MCP server for FreezeText — OCR anything on your Mac screen from Claude/Cursor. Screen capture, region OCR, image OCR, searchable history.

View on GitHub ↗Direct link · no redirect page

Config template (adjust for your client)

claude mcp add freezetext-mcp -- npx -y freezetext-mcp

A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.

Star count: 1 ★ · juergenkoller-software/freezetext-mcp · read from the GitHub search API · (checked 2026-10-16 20:00:20)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
Score: score 703 · 1 ★ · 7 sources · mcp

FAQ (answers come from our records)

How do I install it?

We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository juergenkoller-software/freezetext-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.

Third-party quality signals

FreezeText MCP Server

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

**OCR anything on your Mac screen from Claude, Cursor, or any MCP client.**
This is the official Model Context Protocol server for **FreezeText** — a free native macOS app that freezes the screen and extracts text via Apple Vision OCR. Whether running videos, disappearing popups, protected PDFs, or hover tooltips — FreezeText makes any visible text copyable.
> **You need the FreezeText app installed and running** with its HTTP API enabled (Settings → API). This MCP server talks to the app's local API. Get FreezeText (free) at store.juergenkoller.software/apps/freezetext.
---
What you can do
> "Claude, OCR whatever is on my screen right now and summarize it."
>
> "Cursor, run OCR on this screenshot (base64) and extract the invoice number."
>
> "Search my FreezeText history for everything containing 'tracking number'."
The MCP server exposes **12 tools**:
| Category | Tools |
|---|---|
| **Capture & OCR** | capture_screen (freeze + OCR), capture_region (OCR a specific rect), ocr_image (OCR a base64 image) |
| **History** | list_history, search_history, get_history_entry, add_history, delete_history_entry, clear_history, export_history (JSON/CSV) |
| **OCR config** | get_ocr_languages, set_ocr_languages |
All OCR runs locally via Apple Vision Framework — no cloud, no data transmission.
---
Installation
Prerequisites
1. **macOS 14 (Sonoma) or later**
2. **FreezeText app installed and running** — get it free here — with the HTTP API enabled in Settings
3. **Swift 5.9+** (Xcode 15+) if building from source
Build from source
Pre-built binary
See Releases.
---
Configuration
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
FREEZETEXT_API_TOKEN is only required if you set an API token in FreezeText's Settings.
Claude Code
Cursor / other MCP clients
Same pattern — stdio MCP server, configured via the two env vars above.
---
How it works
This is a full MCP server (built on the official modelcontextprotocol/swift-sdk) that maps MCP tool calls to FreezeText's local HTTP API. The OCR engine (Apple Vision), screen capture, and history storage live in the FreezeText app.
---
Environment variables
| Variable | Default | Description |
|---|---|---|
| FREEZETEXT_API_PORT | 9876 | Port of FreezeText's local HTTP API |
| FREEZETEXT_API_TOKEN | _(none)_ | Bearer token — only if set in FreezeText Settings |
---
About FreezeText
FreezeText is a **free** native macOS OCR utility. Highlights:
- **Free**, no subscription, no sign-up