mcpField
O
OFD Reader (China e-invoices)

OFD Reader (China e-invoices)

Local
okagent.krFinance0Updated 6d ago
RepositoryVisit website

About OFD Reader (China e-invoices)

OFD Reader is an MCP server for agents that need to read Chinese OFD e-invoices and other documents. It extracts invoice fields, page-ordered text, and document metadata without requiring keys.

Key features

  1. 01Extract invoice fields
  2. 02Rebuild page-by-page text
  3. 03Read document metadata
  4. 04Accept path, URL, or base64 input

Use cases

  1. 01Extract totals and tax IDs from e-invoices
  2. 02Read text from official documents
  3. 03Inspect bank statements and attachments

MCP support

Exposes OFD invoice, text, and metadata tools to MCP clients. It can run locally or use the hosted endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "groove79-mcp-ofd": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-ofd"
      ]
    }
  }
}
Run commandnpx -y @appmonster/mcp-ofd

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@appmonster/mcp-ofd0.1.0

Tools

3

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
urlstringNohttp(s) URL of a .ofd file
pathstringNoLocal file path of a .ofd file
base64stringNoBase64 file contents (for clients that cannot share a path)
maxCharsintegerNo

Details

From the project 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.

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:

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

Part of K-MCP. MIT.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.