Handwriting OCR MCP Server

Handwriting OCR MCP Server

Handwriting OCR用のModel Context Protocol（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"
        }
    }
}

リモートサーバーの追加方法はクライアントによって異なります（「Connectors」UI を使うもの、「"type": "http"」が必要なもの、stdio のみ対応するクライアントで mcp-remote プロキシを介して接続するものがあります）。お使いのクライアントのリモート MCP に関するドキュメントを参照してください。

以下で説明するローカルサーバーも引き続き使用でき、セルフホストやオフライン環境で役立つ場合がありますが、ホスト型サーバーのほうが簡単なため、こちらをおすすめします。

---

セルフホスト（ローカル）サーバー

このドキュメントの以降の部分では、API トークンを使用してHandwriting OCR APIと通信するローカルの Node.js サーバーの実行方法を説明します。

概要

Handwriting OCR MCP Server を使うと、MCP クライアントと Handwriting OCR サービスを連携できます。このドキュメントでは、セットアップ手順と、クライアントの基本的な使用例を紹介します。

このサーバーでは、画像や PDF ドキュメントをアップロードし、ステータスを確認して、OCR 結果を Markdown 形式で取得できます。

ツール

文字起こし

• ドキュメントをアップロード
• ステータスを確認
• テキストを取得

前提条件

始める前に、以下を用意してください。

• システムに 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 Server を使用するには、以下を使用します。

{
    "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 Server では、認証と設定に環境変数を使用できます。

• API_TOKEN：API トークンです。

これらの値は、Handwriting OCR Platformの API 設定ダッシュボードで確認できます。

サポート

Handwriting OCR API ドキュメントを参照してください。

Handwriting OCR MCP Server のサポートについては、GitHub Issueを送信してください。

概要

Handwriting OCR Platform 用の Model Context Protocol（MCP）サーバー