使用说明
RapidOCR MCP服务器
高性能OCR MCP服务器。
特性
- 多模式:MCP stdio、FastAPI HTTP、可流式传输HTTP
- 多输入:路径、Base64、URL、文件上传
- 批量OCR:在一个请求中处理多个图像
- 输出格式:纯、JSON、Markdown、结构化
- 图像预处理:自动增强、旋转、二值化
- 安全:路径白名单、API密钥、CORS、审核日志记录
- 监控:普罗米修斯指标,OpenTetry跟踪
- 生产就绪:Docker、CI/CD、测试
快速开始
全球安装
# Install globally with uvx (recommended)
uvx rapidocr-mcp
# Or install globally with pip
pip install rapidocr-mcp
本地开发
# Install dependencies
uv sync
# Run MCP server (stdio mode)
uv run rapidocr-mcp
# Run FastAPI server
uv run rapidocr-mcp --mode fastapi --port 8080
配置
设置环境变量 RAPIDOCR_ 前缀:
export RAPIDOCR_LANG=ch
export RAPIDOCR_LOG_LEVEL=INFO
export RAPIDOCR_API_KEY=your-key
MCP配置
可用工具
| 工具 | 说明 |
|---|---|
ocr_by_path |
按路径对本地图像文件进行OCR |
ocr_by_content |
Base64编码图像的OCR |
ocr_by_url |
从HTTP/HTTPS URL获取图像的OCR |
ocr_batch |
多幅图像的批量OCR |
克劳德桌面
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"rapidocr": {
"command": "uvx",
"args": ["rapidocr-mcp"]
}
}
}
或者本地安装:
{
"mcpServers": {
"rapidocr": {
"command": "uv",
"args": ["--directory", "/path/to/rapidocr-mcp", "run", "rapidocr-mcp"]
}
}
}
其他MCP客户端
对于支持stdio模式的其他MCP客户端,请将命令配置为:
uvx rapidocr-mcp
# or
rapidocr-mcp
码头工人
docker-compose -f docker/docker-compose.yml up
API终点
GET /health-健康检查POST /ocr/path-按文件路径进行OCRPOST /ocr/base64-基于base64的OCRPOST /ocr/url-通过URL进行OCRPOST /ocr/upload-通过文件上传进行OCRGET /metrics-普罗米修斯指标
赞助
如果你觉得这个项目有帮助,可以考虑给我买杯咖啡!
许可证
麻省理工学院