FastOCR

io.github.fastocr-org由 GitHub 账号 fastocr-org 发布v0.3.0更新于 Nov 7, 2026

OCR scanned PDFs and extract bank statements to Excel, CSV and QuickBooks with FastOCR.

发布方自己的服务：Fastio

已验证STDIO仅桌面文件与存储金融数据与分析

服务详情

标识符: io.github.fastocr-org/fastocr-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Oct 25, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 fastocr-org。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.fastocr-org%2Ffastocr-mcp.svg)](https://sourceweft.com/mcp/io.github.fastocr-org%2Ffastocr-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

FastOCR 让助手对本地扫描版 PDF 和图片做 OCR、生成可搜索 PDF，并把银行对账单转换为 Excel、CSV 或 QuickBooks 文件。

可以做什么: 对本地 PDF 或图片做 OCR，返回文本，或在原文件旁保存可搜索 PDF
查询文档状态与页数，或再次获取已完成的结果
列出账户中最近的文档，并删除已存储的文档
把银行对账单提取为 xlsx、csv、json、qbo、quickbooks_csv、qfx 或 ofx，并返回余额摘要
查询账户剩余页数
适用场景: 当磁盘上有扫描件或图片，想直接取得文字、可搜索副本，或结构化的银行对账单导出时适用。也适合在批量处理前查看剩余 OCR 页数。
运行要求: 通过 uvx fastocr-mcp（或 pip install fastocr-mcp）以 stdio 在本地运行；需要 Python 3.10 或更高版本，并在 FASTOCR_API_KEY 中提供 FastOCR 账户的 API 密钥。需要访问 FastOCR API 的网络连接；可用 FASTOCR_BASE_URL 覆盖接口地址。

安装前请注意

会把选中的本地文件上传到 FastOCR API，文档内容会离开本机。用量按页计费：每月 20 页免费，之后需购买 Page Pack，银行对账单页数为独立余额。delete_document 会删除 FastOCR 上的文档及其存储文件。银行对账单提取工具标注为 beta。

安装

在 SourceWeft 中

打开控制台中的 FastOCR，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

[FastOCR]

OCR any scanned PDF or image from Claude, Cursor and other MCP clients.

[CI] [PyPI] [Python] [License: MIT]

Website · Docs · Get an API key

[FastOCR reads a scanned page in English, Arabic and Hindi and returns its text]

An MCP server that lets your client OCR a local scanned PDF or image over stdio; files go only to the FastOCR API.

Quickstart

Create an API key in the developer console.
Add the server to Claude Code:

Ask: "OCR ~/Scans/contract.pdf".

With uv there is nothing to install; the client runs uvx fastocr-mcp. Prefer pip? Run pip install fastocr-mcp and use the command fastocr-mcp. Python 3.10 or newer.

Other clients

Every client needs the same command, uvx fastocr-mcp, and your key in FASTOCR_API_KEY.

Claude Desktop

Add this to claude_desktop_config.json (Settings > Developer > Edit Config), then restart Claude Desktop:

json

{  "mcpServers": {    "fastocr": {      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

{  "mcpServers": {    "fastocr": {      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

json

{  "mcpServers": {    "fastocr": {      "type": "stdio",      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

{  "mcpServers": {    "fastocr": {      "type": "stdio",      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

VS Code

Add this to .vscode/mcp.json in your workspace. VS Code uses servers, not mcpServers:

json

{  "servers": {    "fastocr": {      "type": "stdio",      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

{  "servers": {    "fastocr": {      "type": "stdio",      "command": "uvx",      "args": ["fastocr-mcp"],      "env": { "FASTOCR_API_KEY": "your_api_key" }    }  }}

If you installed with pip, use "command": "fastocr-mcp" and "args": [].

Examples

Ask your client in plain language:

"OCR ~/Downloads/scanned-contract.pdf and summarize the termination clause."
"Read the text in /Users/me/Desktop/receipt.jpg."
"Make a searchable copy of /Users/me/archive/1998-letters.pdf."
"List my last five FastOCR documents."

[An MCP client calls ocr_file on a scanned letter and gets back its text]

The text above is the unedited output FastOCR returned for a scanned page.

Tools

Tool	What it does
`ocr_file(path, output="text", output_path=None)`	Uploads a local PDF or image, runs OCR and waits up to 45 seconds; a larger document returns its id for `get_document`. `output="text"` returns the text (text over 20,000 characters is cut, and the full text is saved to `output_path` or `<file>.ocr.txt` next to the input file). `output="pdf"` saves a searchable PDF to `output_path` or `<file>.searchable.pdf`.
`ocr_pdf(path, output="text", output_path=None)`	The same tool as `ocr_file` under its earlier name, kept so existing setups keep working.
`get_document(document_id, output="status", output_path=None)`	Status and page counts of a document; with `output="text"` or `"pdf"`, waits up to 45 seconds and fetches the finished result. Fetching a result again costs no pages.
`list_documents(limit=20)`	The most recent documents in the account, newest first.
`extract_bank_statement(path, format="xlsx", output_path=None, account=None, transactions=10)`	Beta. Uploads a bank statement (PDF, PNG, JPG, JPEG or WebP), waits up to 45 seconds, saves the file (`xlsx`, `csv`, `json`, or the accounting files `qbo`, `quickbooks_csv`, `qfx`, `ofx`; one file per account) beside the input as `<file>.transactions.<ext>`, and returns the bank, each account's balances and whether they reconcile, `needs_review`, the transaction count and the first transactions.
`get_bank_statement(statement_id, format="xlsx", output_path=None, account=None, transactions=10)`	Waits up to 45 seconds for a statement that `extract_bank_statement` did not finish, then saves the file and returns the same summary. Fetching again costs no pages.
`get_balance()`	The pages left on the account: free pages (they reset monthly), contract pages if any, and Page Packs, plus the link to buy more. Costs no pages.
`delete_document(document_id)`	Deletes a document and its stored files on FastOCR. Local files are not touched.

What you get back

You get	How
The text of the document	`ocr_file(path)`, or `get_document(id, output="text")`
A searchable PDF	`ocr_file(path, output="pdf")`, saved beside the input
Status and page counts	`get_document(id)`
A bank statement as Excel, CSV, JSON or QuickBooks files, with a summary	`extract_bank_statement(path)`
Your recent documents	`list_documents()`

Languages and files

100+ languages, detected automatically. No language setting is needed.
PDF files up to 1 GiB, and PNG, JPG, JPEG, GIF, WebP and BMP images up to 20 MiB. An image counts as one page.
Built on the official fastocr-sdk and the official MCP Python SDK.

Pages and pricing

Any signed-in FastOCR account can create an API key and start right away. Every account gets 20 free pages a month, shared with PDFs on the website; an image is one page. When you need more, buy a Page Pack on the pricing page. Packs and the page balance are the same on the website and in the API; ask your agent to run get_balance to see what is left. Bank statement pages are a separate balance (statement_pages_remaining in get_balance), shared with the website's bank statement converter; new accounts start with some free statement pages. Accounts process 2 documents at once, or 10 with an API contract or 10,000 or more pages bought. You accept the API terms with your first key.

Errors and configuration

Tool errors are written for the agent to act on: a rejected key, an account out of pages (buy_pages), too many documents processing at once (concurrency_limit), a missing file, or an unsupported file type. Each message says what to do next. A document that runs out of pages fails with buy_pages; the tool says so and links to the pricing page. Error codes are listed in the API docs.

Support and license

Questions: [email protected]. Bugs and requests: GitHub issues. Python SDK: fastocr-python. MIT license; see LICENSE. Made by FastOCR.

来源：README.md，提交 727f2fb

工具

ocr_file

OCR a local PDF or image with FastOCR and return its text or save a searchable PDF. Uploads the file, runs OCR and waits up to 45 seconds. With output='text' the text is returned; text longer than 20,000 characters is cut, and the full text is written to output_path or to <file>.ocr.txt next to the input file. With output='pdf' the searchable PDF is saved to output_path or to <file>.searchable.pdf next to the input file. Either default file replaces an earlier result with the same name. Each processed page uses one page of the account's balance; an image is one page. Large documents take longer: then this returns a document id, and get_document with the same output fetches the result. Never call ocr_file again for that file, which bills it again.

输入参数path必填outputoutput_path

ocr_pdf

The same tool as ocr_file, kept under its earlier name. Prefer ocr_file.

输入参数path必填outputoutput_path

get_document

Get a FastOCR document's status, and optionally its text or searchable PDF. Statuses: awaiting_upload, processing, completed, partial (the account ran out of pages partway), failed. With output='text' or 'pdf' this waits up to 45 seconds; if the document is still processing, call it again. Fetching a result again costs no pages. Without output_path, long text and PDFs are saved in the system temp directory.

输入参数outputdocument_id必填output_path

list_documents

List the most recent documents in the FastOCR account with their status and page counts.

输入参数limit

get_balance

Get how many pages the FastOCR account can still process. Costs no pages. Documents spend free pages first (they reset monthly), then contract pages, then Page Packs. pages_remaining counts the Page Packs only, so add the free and contract pages for the total. contract_* are omitted without an API contract. statement_pages_remaining is a separate balance that OCR does not spend. Check this before OCRing a large PDF; buy_pages_url is where to add pages.

无需输入参数。

delete_document

Permanently delete a FastOCR document and its stored files (original, text, searchable PDF). A document that is still processing cannot be deleted. Local files are not touched.

输入参数document_id必填

extract_bank_statement

Extract the transactions of a bank statement with FastOCR and save them as a file. Uploads the statement, waits up to 45 seconds, saves the file (default <statement>.transactions.xlsx beside the input, replacing an earlier one) and returns JSON: the bank, each account with opening and closing balance, totals and whether the printed balances reconcile with the transactions, needs_review, the transaction count and the first transactions. needs_review true means some figures should be checked by a person. Each statement page uses one page of the account's statement balance (50 free pages for new accounts); never run it twice on the same file. A long statement returns a statement id: call get_bank_statement with it. Beta.

输入参数path必填formataccountoutput_pathtransactions

get_bank_statement

Wait up to 45 seconds for a bank statement to finish, then save its file and return its summary. Use it after extract_bank_statement returned a statement id. Fetching again costs no pages. If the statement is still processing, call it again with the same arguments. Without output_path the file is saved in the system temp directory.

输入参数formataccountoutput_pathstatement_id必填transactions