内容
# 冻结文本 MCP 服务器
[](https://swift.org)
[](https://apple.com/macos)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/juergenkoller-software/freezetext-mcp)
**从 Claude、Cursor 或任何 MCP 客户端中对 Mac 屏幕上的任意内容进行 OCR。**
这是 [**FreezeText**](https://store.juergenkoller.software/en/apps/freezetext) 的官方 [模型上下文协议](https://modelcontextprotocol.io) 服务器 — 一款免费的原生 macOS 应用，冻结屏幕并通过 Apple Vision OCR 提取文本。无论是运行视频、消失的弹出窗口、受保护的 PDF 文件还是悬停提示 — FreezeText 使任何可见文本都可复制。
> **您需要安装并运行 FreezeText 应用**，并启用其 HTTP API（设置 → API）。此 MCP 服务器与应用的本地 API 进行通信。在 [store.juergenkoller.software/apps/freezetext](https://store.juergenkoller.software/en/apps/freezetext) 处免费获取 FreezeText。
---
## 功能
> “Claude，立即对我的屏幕进行 OCR 并总结。”
>
> “Cursor，对此截图（base64）运行 OCR 并提取发票号码。”
>
> “在我的 FreezeText 历史记录中搜索所有包含“跟踪号码”的内容。”
MCP 服务器公开 **12 种工具**：
| 类别 | 工具 |
|---|---|
| **捕获与 OCR** | `capture_screen`（冻结 + OCR），`capture_region`（OCR 特定矩形），`ocr_image`（OCR base64 图像） |
| **历史记录** | `list_history`，`search_history`，`get_history_entry`，`add_history`，`delete_history_entry`，`clear_history`，`export_history`（JSON/CSV） |
| **OCR 配置** | `get_ocr_languages`，`set_ocr_languages` |
所有 OCR 操作均通过 Apple Vision Framework 在本地运行 — 无云，无数据传输。
---
## 安装
### 先决条件
1. **macOS 14（Sonoma）或更高版本**
2. **FreezeText 应用已安装并运行** — [在此处免费获取](https://store.juergenkoller.software/en/apps/freezetext) — 并在设置中启用 HTTP API
3. **Swift 5.9+**（Xcode 15+），如果从源代码构建
### 从源代码构建
```bash
git clone https://github.com/juergenkoller-software/freezetext-mcp.git
cd freezetext-mcp
swift build -c release
# 二进制文件：.build/release/FreezeTextMCP
```
### 预编译二进制文件
参见 [发行版](https://github.com/juergenkoller-software/freezetext-mcp/releases)。
---
## 配置
### Claude 桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"freezetext": {
"command": "/path/to/FreezeTextMCP",
"env": {
"FREEZETEXT_API_PORT": "9876",
"FREEZETEXT_API_TOKEN": "your-token-if-set"
}
}
}
}
```
`FREEZETEXT_API_TOKEN` 仅在 FreezeText 设置中设置了 API 令牌时才需要。
### Claude 代码
```bash
claude mcp add freezetext /path/to/FreezeTextMCP \
--env FREEZETEXT_API_PORT=9876
```
### Cursor / 其他 MCP 客户端
相同的模式 — stdio MCP 服务器，通过上述两个环境变量进行配置。
---
## 工作原理
```
┌────────────────┐ JSON-RPC stdio ┌────────────────┐ HTTP(+Bearer) ┌────────────────┐
│ Claude/Cursor │ ───────────────► │ FreezeTextMCP │ ────────────────► │ FreezeText.app│
│ (MCP 客户端) │ ◄─────────────── │ (此仓库) │ ◄──────────────── │ (端口 9876) │
└────────────────┘ └────────────────┘ └────────────────┘
```
这是一个完整的 MCP 服务器（基于官方 [`modelcontextprotocol/swift-sdk`](https://github.com/modelcontextprotocol/swift-sdk)），它将 MCP 工具调用映射到 FreezeText 的本地 HTTP API。OCR 引擎（Apple Vision）、屏幕捕获和历史记录存储都位于 FreezeText 应用中。
---
## 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
| `FREEZETEXT_API_PORT` | `9876` | FreezeText 的本地 HTTP API 端口 |
| `FREEZETEXT_API_TOKEN` | _(无)_ | Bearer 令牌 — 仅在 FreezeText 设置中设置 |
---
## 关于 FreezeText
FreezeText 是一款 **免费** 的原生 macOS OCR 实用工具。亮点：
- **免费**，无订阅，无注册
- **极速 OCR** — Apple Vision Framework，低于 0.3 秒
- **冻结屏幕** — 从视频、弹出窗口、受保护的 PDF 文件、悬停提示中捕获文本
- **全局热键**（⌘⇧7）
- **二维码和条形码检测**
- **可搜索历史记录**，带有颜色标签 + JSON/CSV 导出
- **HTTP API**（40+ 端点）— 此 MCP 服务器基于它构建
- **100% 本地** — 无云，无数据传输
→ **[在此处免费获取 FreezeText](https://store.juergenkoller.software/en/apps/freezetext)**
---
## 许可证
MIT — 参见 [LICENSE](LICENSE)。此 MCP 服务器是开源的；FreezeText 应用是免费的（专有）。
## 问题和支持
- **MCP 服务器错误：** [打开问题](https://github.com/juergenkoller-software/freezetext-mcp/issues)
- **应用支持：** [support@juergenkoller.software](mailto:support@juergenkoller.software)
由 [Juergen Koller 软件有限公司](https://juergenkoller.software) 构建。
