Handwriting OCR MCP Server

Handwriting OCR MCP 服务

适用于 Handwriting OCR 的模型上下文协议（MCP）服务。

⭐ 推荐：使用托管（远程）MCP 服务

你不再需要运行此本地服务。Handwriting OCR 现在提供了一个托管 MCP 服务，可直接连接——无需安装 Node.js、无需构建，也无需复制 API 令牌。

• 端点： https://mcp.handwritingocr.com
• 身份验证： OAuth——你的 MCP 客户端会在浏览器中打开登录和授权页面；无需复制或保存令牌。
• 功能比此本地服务更丰富： 提交文档、检查状态、获取结果、导出为 Word / Excel / JSON，以及使用提取器提取结构化字段。它还内置了使用指南，让助手了解服务的功能以及如何获得良好结果。

将其添加到任何支持远程 MCP 服务的客户端。例如，在 Claude Desktop 的配置中：

{
    "mcpServers": {
        "handwriting-ocr": {
            "url": "https://mcp.handwritingocr.com"
        }
    }
}

添加远程服务的具体方式因客户端而异（有些客户端提供“连接器”界面，有些需要 "type": "http"，而仅支持 stdio 的客户端可以通过 mcp-remote 代理进行连接）。请参阅客户端的远程 MCP 文档。

下文所述的本地服务仍可使用，适合可自托管或离线环境，但托管服务更易使用，也更受推荐。

---

自托管（本地）服务

本文档其余部分介绍如何运行本地 Node.js 服务，该服务使用 API 令牌与 Handwriting OCR API 交互。

概览

Handwriting OCR MCP 服务支持 MCP 客户端与 Handwriting OCR 服务集成。本文档介绍设置流程，并提供一个客户端的基本用法示例。

此服务可上传图片和 PDF 文档、检查状态，并以 Markdown 格式获取 OCR 结果。

工具

转录

• 上传文档
• 检查状态
• 获取文本

前提条件

开始之前，请确保具备以下条件：

• 系统已安装 Node.js（建议使用 18.x 或更高版本）。
• 拥有有效的 Handwriting OCR Platform 帐户和有效的 API 令牌。

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 handwriting-ocr-mcp-server：

npx -y @smithery/cli install @Handwriting-OCR/handwriting-ocr-mcp-server --client claude

为 Claude Desktop 手动安装

如需在 Claude Desktop 应用中使用 Handwriting OCR MCP 服务，请使用：

{
    "mcpServers": {
        "handwriting-ocr": {
            "command": "node",
            "args": [
                "/Users/mateo/Local/Code/MCP/handwriting-ocr/build/index.js"
            ],
            "env": {
                "API_TOKEN": "your-api-token",
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

配置

Handwriting OCR MCP 服务支持通过环境变量设置身份验证和配置：

• API_TOKEN：你的 API 令牌。

你可以在 Handwriting OCR Platform 的 API 设置控制面板中找到这些值。

支持

请参阅 Handwriting OCR API 文档。

如需获取 Handwriting OCR MCP 服务的支持，请提交 GitHub Issue。

关于

适用于 Handwriting OCR Platform 的模型上下文协议（MCP）服务