Skip to content
MCP server

ofdkit

Read OFD files and Chinese e-invoices locally: text, invoice fields and folder totals

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, API
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About ofdkit

ofdkit is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.

OFD is China's national fixed-layout document standard (GB/T 33190), used for electronic invoices and official documents. ofdkit is a Python library and command-line tool for reading it, and its MCP server lets an assistant open those files without any conversion step. All four tools are read-only.

From an invoice it pulls the number, date, buyer and seller with tax IDs, amounts, tax and line items, and keeps amounts as decimal strings so no precision is lost; warnings flag totals that do not add up. The command line adds a folder or .zip summary exported to Excel, with duplicates highlighted, a check that invoices are made out to the right buyer, and file renaming from invoice contents with preview and undo.

It uses only the Python standard library and tolerates many malformed files. The README is bilingual in Chinese and English and labels the project version 0.4, with the interface still liable to change. The MCP server needs uv.

Install

Run in a terminal

claude mcp add ofdkit -- uvx ofdkit

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ofdkit": {
      "command": "uvx",
      "args": [
        "ofdkit"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ofdkit": {
      "command": "uvx",
      "args": [
        "ofdkit"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ofdkit": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ofdkit"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ofdkit": {
      "command": "uvx",
      "args": [
        "ofdkit"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ofdkit": {
      "command": "uvx",
      "args": [
        "ofdkit"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

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

read_ofd_text
Extract text in reading order, with optional Markdown and page range.
read_ofd_invoice
Return invoice fields.
ofd_info
Return page count, sizes and metadata.
list_ofd_invoices
Summarise a folder of invoices, optionally checking the buyer.

What it does

Invoice field extraction
Reads number, date, buyer, seller, amounts and line items from an OFD e-invoice.
Folder and zip totals
Summarises many invoices, including tax-platform zip downloads, with totals and duplicate flags.
Buyer check
Flags invoices whose buyer name or tax ID does not match yours.
Rename by content
Renames invoice files from their details, with preview and undo log.
Reading-order text
Extracts text in order, including templates and composite objects.
No dependencies
Runs on the Python standard library alone.

Good for

  • Total a month of reimbursement invoices into Excel
  • Check that every invoice names the right company
  • Extract invoice data as JSON for accounting software
  • Let an assistant read an OFD official document
  • Rename downloaded invoices by date, seller and amount

Pricing

Free

Free to install from PyPI

ofdkit FAQ

What is an OFD file?

A Chinese national standard document format, GB/T 33190, common for e-invoices and official documents.

Which tools does the MCP server provide?

read_ofd_text, read_ofd_invoice, ofd_info and list_ofd_invoices, all read-only.

What do I need installed?

Python 3.10 or newer, and uv for the MCP server.

Does it handle precision in amounts?

Yes, amounts are kept as decimal strings and only real numbers are summed.

Is ofdkit free?

Yes. ofdkit is free to use.

How do I add ofdkit to Claude Code?

Run this command in your terminal: claude mcp add ofdkit -- uvx ofdkit

What are the best alternatives to ofdkit?

The closest alternatives to ofdkit are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, SSRS2 and Crypto Feeds.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers