Docling をサービスとして動かす——docling-serve、API、MCP

pip install "docling-serve[ui]"
docling-serve run --enable-ui          # API：http://127.0.0.1:5001 · ドキュメント：/docs · UI：/ui

docker run -p 5001:5001 -e DOCLING_SERVE_ENABLE_UI=1 \
  quay.io/docling-project/docling-serve-cpu

curl -X POST http://localhost:5001/v1/convert/source \
  -H 'Content-Type: application/json' \
  -d '{
    "sources": [{"kind": "http", "url": "https://arxiv.org/pdf/2408.09869"}],
    "options": {"to_formats": ["md", "json"], "do_ocr": false}
  }'

curl -X POST http://localhost:5001/v1/convert/file \
  -F 'files=@report.pdf' \
  -F 'to_formats=md' \
  -F 'do_ocr=false' \
  -F 'table_mode=fast'

import time, requests

BASE = "http://localhost:5001"
job = requests.post(f"{BASE}/v1/convert/source/async", json={
    "sources": [{"kind": "http", "url": "https://arxiv.org/pdf/2408.09869"}],
    "options": {"to_formats": ["md"]},
}).json()

task_id = job["task_id"]
while True:
    status = requests.get(f"{BASE}/v1/status/poll/{task_id}").json()
    if status["task_status"] in ("success", "partial_success", "failure"):
        break
    time.sleep(2)

result = requests.get(f"{BASE}/v1/result/{task_id}").json()
print(result["document"]["md_content"][:300])

from docling.datamodel.service.options import ConvertDocumentsOptions
from docling.service_client import DoclingServiceClient

with DoclingServiceClient(url="http://localhost:5001") as client:   # 設定済みなら api_key="..."
    result = client.convert(
        "https://arxiv.org/pdf/2408.09869",
        options=ConvertDocumentsOptions(do_ocr=False, to_formats=["md"]),
    )
    print(result.document.export_to_markdown()[:300])

{
  "mcpServers": {
    "docling": {
      "command": "uvx",
      "args": ["--from=docling-mcp", "docling-mcp-server"],
      "env": {
        "DOCLING_MCP_CONVERSION_MODE": "remote",
        "DOCLING_MCP_SERVICE_URL": "http://localhost:5001"
      }
    }
  }
}

uvx --from "docling-mcp[local]" docling-mcp-server --transport stdio
# 環境変数 DOCLING_MCP_CONVERSION_MODE=local を設定