OFD Reader MCP — 중국 전자세금계산서(发票)·OFD 문서 읽기

중국의 문서 표준 OFD(GB/T 33190) 파일 — 电子发票·数电票, 공문서, 거래명세서 — 의 본문과 세금계산서 항목(번호·발행일·구매자·판매자·세액·합계)을 추출하는 무료 오픈소스 MCP 서버입니다. Read Chinese OFD e-invoices and documents.

@appmonster/mcp-ofd무료 · MIT 오픈소스API 키 필요 없음GitHub →

무엇을 할 수 있나

도구	하는 일
`ofd_invoice_fields`	세금계산서 항목(번호·날짜·구매자·판매자·금액) 추출
`ofd_to_text`	페이지별 본문 텍스트
`ofd_info`	문서 정보(쪽수·서명 여부·첨부)

설치 없이 바로 · 키 필요 없음

주소 하나만 넣으면 됩니다

이 서버의 조회 도구는 okagent.kr 원격 서버로도 제공합니다. 하루 100회까지 무료이고, 파일 경로 대신 URL이나 base64로 넘깁니다.

https://okagent.kr/api/mcp

Claude — 설정 → 커넥터 → 사용자 지정 커넥터 추가
ChatGPT — 앱 및 커넥터 → 개발자 모드 → 커넥터 만들기 (인증 없음)
Claude Code — claude mcp add --transport http okagent https://okagent.kr/api/mcp

내 컴퓨터에 설치 (1분)

Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.

Claude Desktop · Cursor · Windsurf

MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.

{
  "mcpServers": {
    "ofd": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-ofd"
      ]
    }
  }
}

Claude Code

claude mcp add ofd -- npx -y @appmonster/mcp-ofd

필요한 키와 발급처

필요 없습니다. 설치하면 바로 씁니다.

이렇게 시켜 보세요

“이 发票 OFD 파일에서 발행일, 판매자, 세금 포함 합계만 표로 정리해줘.”
“이 OFD 공문 내용을 한국어로 요약해줘.”

자주 묻는 질문

OCR인가요?

아니요. OFD 안의 글자 데이터와 태그를 직접 읽어 정확합니다. 스캔 이미지만 있는 OFD는 글자가 나오지 않습니다.