OFD Reader (China e-invoices)
Read Chinese OFD documents: e-invoice (fapiao) fields, full text and file metadata
- 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-ofdAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-ofd": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-ofd"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-ofd": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-ofd"
]
}
}
}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)

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments