Mcp Ocr

MCP OCR 服务

这是一个使用 MCP（Model Context Protocol）构建的生产级 OCR 服务，通过简单的接口提供 OCR 功能。

功能

• 使用 Tesseract OCR 从图像中提取文本
• 支持多种输入类型：
  • 本地图像文件
  • 图像 URL
  • 原始图像字节
• 自动安装 Tesseract
• 支持多种语言
• 生产就绪的错误处理

安装

# Using pip
pip install mcp-ocr

# Using uv
uv pip install mcp-ocr

在受支持的平台上，Tesseract 将自动安装：

• macOS（通过 Homebrew）
• Linux（通过 apt、dnf 或 pacman）
• Windows（提供手动安装说明）

用法

作为 MCP 服务

1. 启动服务：

python -m mcp_ocr

2. 配置 Claude for Desktop： 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "ocr": {
            "command": "python",
            "args": ["-m", "mcp_ocr"]
        }
    }
}

可用工具

perform_ocr

从图像中提取文本：

# From file
perform_ocr("/path/to/image.jpg")

# From URL
perform_ocr("https://example.com/image.jpg")

# From bytes
perform_ocr(image_bytes)

get_supported_languages

列出可用的 OCR 语言：

get_supported_languages()

开发

1. 克隆代码库：

git clone https://github.com/rjn32s/mcp-ocr.git
cd mcp-ocr

2. 设置开发环境：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

3. 运行测试：

pytest

贡献

1. Fork 代码库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

安全

• 切勿提交 API 令牌或敏感凭据
• 使用环境变量或安全的凭据存储方式
• 遵循 GitHub 的安全最佳实践

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

• Tesseract OCR
• Model Context Protocol