NDLOCR-lite MCP

NDLOCR-lite のCLIの薄いラッパーとして機能するMCPサーバ

必要なもの

• uv — パッケージマネージャ。公式インストール手順に従ってインストールしてください。

MCPクライアント別の設定マニュアル

Claude Desktop

1. 設定ファイルをテキストエディタで開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. mcpServers に以下を追加します。

   {
     "mcpServers": {
       "ndlocr-lite": {
         "command": "uvx",
         "args": ["ndlocr-lite-mcp"]
       }
     }
   }
   

3. Claude Desktop を再起動します。

Cursor

1. プロジェクトルートに .cursor/mcp.json を作成します（グローバル設定の場合は ~/.cursor/mcp.json）。

2. 以下の内容を記述します。

   {
     "mcpServers": {
       "ndlocr-lite": {
         "command": "uvx",
         "args": ["ndlocr-lite-mcp"]
       }
     }
   }
   

3. Cursor を再起動します。

VS Code（GitHub Copilot）

1. プロジェクトルートに .vscode/mcp.json を作成します。

2. 以下の内容を記述します。

   {
     "servers": {
       "ndlocr-lite": {
         "command": "uvx",
         "args": ["ndlocr-lite-mcp"]
       }
     }
   }
   

3. VS Code を再起動し、Copilot Chat から MCP ツールが利用可能になっていることを確認します。

ツールリファレンス

ocr_file

1つのファイルに対してOCRを実行します。

パラメータ

レスポンス

{
  "source": "/path/to/image.webp",
  "pages": [
    {
      "page": 1,
      "text": "認識されたテキスト全文",
      "regions": [
        {
          "order": 0,
          "type": "本文",
          "text": "行のテキスト",
          "bbox": [100, 200, 400, 30],
          "conf": 0.942
        }
      ],
      "viz_path": "/path/to/output/viz_image.jpg"
    }
  ]
}

• viz_path は viz=true かつ output_dir を指定した場合のみ含まれます。
• PDF は1ページにつき1エントリが pages に追加されます（複数ページ PDF は pages の要素数がページ数と一致します）。

ocr_directory

ディレクトリ内のすべての対応ファイルに対してOCRを実行します。

パラメータ

source にディレクトリパスを指定する点以外は ocr_file と同じです。

レスポンス

{
  "source": "/path/to/dir",
  "files": [
    {
      "file": "image01.jpg",
      "pages": [{ "page": 1, "text": "...", "regions": [] }]
    },
    {
      "file": "broken.heic",
      "error": "conversion failed: ..."
    }
  ]
}

• 変換またはOCRに失敗したファイルは pages の代わりに error フィールドを持ちます。

対応フォーマット一覧

NDLOCR-lite 帰属表示

本プロジェクトは国立国会図書館が CC BY 4.0 ライセンスで公開している NDLOCR-lite を利用しています。

ライセンス

MIT License