Skip to content
MCP server

OFD Reader (China e-invoices)

Read Chinese OFD documents: e-invoice (fapiao) fields, full text and file metadata

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About OFD Reader (China e-invoices)

OFD Reader (China e-invoices) is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

OFD is China's fixed-layout document format, used for e-invoices, many official documents and bank statements, and most assistants cannot open it. This server reads it. ofd_invoice_fields pulls invoice number and code, issue date, buyer and seller names and tax IDs, amount before tax, tax, total and check code, from embedded tags where present and otherwise from printed labels. ofd_to_text returns the full text page by page, rebuilt from glyph positions. ofd_info gives title, creator, dates, page count, whether it is signed and any attachments.

Pass exactly one of a local path, a URL or base64 content. Safety limits are stated: only XML parts are decompressed (32 MB each, 96 MB total), XML entity declarations are refused, and nothing is written to disk. No API keys are needed. It runs locally via npx, or as part of the hosted K-MCP endpoint, and is MIT licensed.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ofd": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-ofd"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-ofd": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-ofd"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

ofd_invoice_fields
Extracts invoice fields such as number, date, parties, tax IDs and amounts
ofd_to_text
Returns full document text page by page
ofd_info
Returns title, creator, dates, page count, signature status and attachments

What it does

Invoice field extraction
Reads invoice numbers, parties, tax IDs and amounts.
Page-by-page text
Rebuilds reading-order text from glyph positions.
Document metadata
Shows title, dates, page count and signature status.
Three input modes
Accepts a path, URL or base64 data.
Defensive parsing
Size limits and refused XML entities; nothing written.
No keys
Works without credentials.

Good for

  • Extract totals and tax IDs from a Chinese e-invoice
  • Read an OFD bank statement as text
  • Check whether an OFD file is signed
  • Feed supplier invoices into bookkeeping

Pricing

Open source

MIT licensed; free

Prices change. Check okagent.kr before you buy.

OFD Reader (China e-invoices) FAQ

Do I need an API key?

No keys are needed.

What inputs does it take?

Exactly one of path, url or base64.

Is it safe with untrusted files?

The README says only XML parts are inflated within size limits, entity declarations are refused and nothing is written.

What licence?

MIT.

Is OFD Reader (China e-invoices) free?

Yes. OFD Reader (China e-invoices) is open source, so you can use and self-host it for free.

How do I add OFD Reader (China e-invoices) to Claude Code?

Run this command in your terminal: claude mcp add mcp-ofd -- npx -y @appmonster/mcp-ofd

What are the best alternatives to OFD Reader (China e-invoices)?

The closest alternatives to OFD Reader (China e-invoices) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, ASTra and Quantivex Research.

Alternatives to OFD Reader (China e-invoices)

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments