OCR MCP Server

MCP (Model Context Protocol) 服务器，让 Claude Code / Cursor / Windsurf 等 AI 编码工具通过 MCP 协议直接调用 OCR 文字识别服务。

功能

参数说明

ocr_recognize 和 ocr_table 支持以下参数（三选一，优先级从高到低）：

直接给文件路径即可，MCP Server 会自动读取文件并处理。

环境变量

接入配置

Claude Code

项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "ocr": {
      "command": "uvx",
      "args": ["wk-ocr-mcp"],
      "env": {
        "OCR_SERVICE_URL": "https://gogs.wxapp.info/ocr-api"
      }
    }
  }
}

或 pip install 后：

{
  "mcpServers": {
    "ocr": {
      "command": "python3",
      "args": ["-m", "ocr_mcp_server"],
      "env": {
        "OCR_SERVICE_URL": "https://gogs.wxapp.info/ocr-api"
      }
    }
  }
}

Cursor / Windsurf

分别放到项目根目录 .cursor/mcp.json 或 .codeium/windsurf/mcp_config.json，格式同上。

OCR_SERVICE_URL 配置说明

OCR_SERVICE_URL 必须指向 API 路径前缀：

代码会在此基础拼接端点：{URL}/ocr、{URL}/table、{URL}/health

使用方式

配置好后重启工具，直接用自然语言：

帮我识别这张图片里的文字: /path/to/screenshot.png

这个截图里的表格数据提取出来: /path/to/table.png

AI 会自动调用 ocr_recognize 或 ocr_table，传入文件路径即可完成识别。

License

MIT