OFD Reader (China e-invoices)

io.github.groove79Published by GitHub account groove79v0.1.0Updated Oct 29, 2026

Read Chinese OFD documents: e-invoice (fapiao) fields, official documents, statements. No keys.

VerifiedSTDIODesktop onlyFiles & StorageFinance

Overview

AI-generated overview

Reads Chinese OFD documents locally: full text in reading order and structured e-invoice (fapiao) fields, with no API keys.

What you can do
  • Extract full text of an OFD document page by page, in reading order
  • Pull structured e-invoice fields: invoice number and code, issue date, buyer and seller names and tax IDs, pre-tax amount, tax and total
  • Inspect file metadata: title, author, creator software, creation date, page count, digital signature, attachments and embedded tags
  • Accept the document as a local path, a URL or base64 content
When to use it
Useful when an assistant needs to read Chinese e-invoices (电子发票/数电票), official documents or bank statements in OFD format, which most agents cannot open, and either pull the text or the invoice fields for bookkeeping or review.
Requirements
Runs as a local process via npx from the npm package @appmonster/mcp-ofd, so Node.js is needed; a hosted endpoint is also mentioned for URL or base64 input. No authentication, environment variables or headers are declared. Network access is needed only when the document is supplied by URL.
Before you install
Documents are passed to the server as a path, URL or base64 content, so invoice and bank statement data reaches the tool; when using the hosted endpoint the file is sent to a third-party service. The README states it only inflates XML parts, refuses XML entity declarations and writes nothing.

Installation

In SourceWeft

  1. Open OFD Reader (China e-invoices) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

OFD Reader MCP — Chinese e-invoices (发票) and documents

OFD (GB/T 33190) is China's fixed-layout document format — every e-invoice (电子发票 / 数电票), many official documents and bank statements. Most agents can't open it. This server can: text in reading order, and structured invoice fields.

bash
npx -y @appmonster/mcp-ofd

Hosted (no install, pass url or base64): https://okagent.kr/api/mcp · REST https://okagent.kr/api/tools.

ToolWhat it does
ofd_invoice_fieldsInvoice number/code, issue date, buyer & seller name and tax ID, amount before tax, tax, total, check code — from the invoice's embedded tags, else from printed labels
ofd_to_textFull text, page by page, lines rebuilt from glyph positions (template pages included)
ofd_infoTitle, creator, dates, page count, signed or not, attachments

Pass exactly one of path, url, base64. Safe by design: only XML parts are inflated (32 MB per part, 96 MB total), XML entity declarations are refused, nothing is written.

Claude Desktop config:

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

Part of K-MCP. MIT.

Source: packages/ofd/README.md at commit 53af4ba

Tools

3

ofd_to_text

Read OFD document

Extract the text of a Chinese OFD document (GB/T 33190: e-invoices 电子发票/数电票, official documents, bank statements) in reading order, page by page. Pass exactly one of path | url | base64.

Parametersurlpathbase64maxChars

ofd_invoice_fields

Read OFD e-invoice fields

Extract structured fields from a Chinese OFD e-invoice (发票): invoice number and code, issue date, buyer and seller name and tax ID, amount before tax, tax, total. Uses the invoice's embedded tags, else the printed labels. Pass exactly one of path | url | base64.

Parametersurlpathbase64

ofd_info

OFD file info

Quick facts about an OFD file without the full text: title, author, creator software, creation date, page count, whether it is digitally signed, attachments, embedded tags.

Parametersurlpathbase64

Version history

1
  1. v0.1.0LatestOct 23, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts