memvo_search
Full-text search over stored transactions. Each hit includes a receipt with the source file, line range, file SHA-256 and the raw line. Empty query lists the latest entries.
limitquerysinceuntilperiodaccount
pro.memvo由 memvo.pro 发布v0.1.0a3更新于 Nov 22, 2026
Read-only tools over your own bank statements. Every answer cites the line it came from.
Memvo 的本地 MCP 服务,由 memvo.pro 发布;无需登录;STDIO;7 个工具。
暂无 AI 概览:以下信息来自注册中心条目和服务本身。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
[ci] [PyPI] [Python] [OpenSSF Scorecard] [License: MIT]
Local-first financial memory. Import your statements once, then ask about your money and get the exact line each answer came from.
Memvo keeps every transaction verbatim, next to the SHA-256 of the file it was read from. It never summarises, categorises with a model, or sends data anywhere. Your vault is one SQLite file on your machine.
Status: pre-alpha. The output below is from
tests/fixtures/checking.csv. CSV import, search, audit and reconcile work and are tested, and agents can read the vault over MCP. PDF import and on-chain wallet import are not built yet. See Status.
Ask an assistant "what did I pay for that subscription in October?" and it will often answer with a number it cannot show you. Memvo is built the other way round: an answer is a stored row plus a receipt, or it is nothing.
raw field is the exact text from the file,
including quoted fields that span several lines.Requires Python 3.10 or newer. No other dependencies.
The vault lives at ~/.memvo/vault.db, or $MEMVO_HOME/vault.db, or wherever
--vault points.
To see it work before importing anything of your own:
It imports two made-up statements into a throwaway folder, searches, shows a
receipt, reconciles both accounts, then edits one line of the sample CSV and
lets audit catch it. Your own vault is never opened. --keep DIR keeps the
files.
Releases are built and uploaded by
publish.yml through PyPI trusted
publishing, and each file carries a signed provenance attestation that names
this repository and workflow:
Add --json to any command for machine-readable output.
Column detection reads the header and recognises common English and
Indonesian names (Date/Tanggal, Amount/Jumlah, Debit/Debet,
Credit/Kredit, Balance/Saldo, …). Use --map role=Column when it
guesses wrong. Separators are sniffed (, ; tab |). Amount formats
handled: 1,234.56, 1.234,56, 1 234,56, (12.50), 12.50-,
IDR 1.500.000. Day-first versus month-first is decided once per file by
looking at all its dates.
Rows that cannot be parsed are listed with their line number and reason. They are never guessed.
OFX and QFX files (the "Download for Quicken/Money" option many banks offer)
are read in both the old SGML form and the XML form. Each <STMTTRN> block is
stored verbatim as one entry, its FITID is kept as the bank reference, and
the statement's ledger balance is remembered for reconcile --expect statement.
Overlapping downloads are matched on FITID. Files that are not UTF-8 are read
as Windows-1252.
memvo audit re-reads every imported file. If the file hash still matches,
each entry's raw text is compared with the bytes on disk. A file that changed
or disappeared is reported as CHANGED or MISSING; its entries are kept as
they were imported. It also lists likely duplicates across overlapping
exports (same account, day, amount and text in two different files).
Exit code is 0 when everything matches and 2 when it does not, so it can
run in a cron job or CI.
previous balance + amount = balance. A break points at a missing,
duplicated or misread row. Newest-first and oldest-first files both work.--expect compares the sum of entries (plus
--opening, up to --as-of) with a figure you read off a statement or a
wallet. --expect statement takes that figure from the newest imported
OFX ledger balance.memvo mcp runs a Model Context Protocol server on stdio (tool reference). Register it in any
MCP client:
Tools: memvo_search, memvo_get_entry, memvo_accounts, memvo_periods,
memvo_audit, memvo_reconcile, memvo_stats.
The server is read-only. An agent can search, inspect and check, but it cannot import, edit or delete anything; importing stays a step you take yourself. Every result that mentions an entry carries its receipt, and the server tells the client to cite the source line instead of estimating.
What comes next, and what will not be built: ROADMAP.md.
Coverage must stay at or above 90%, and the suite fails on any network access. See CONTRIBUTING.md.
Memvo makes no network calls. Nothing is uploaded, and there is no telemetry. Delete the vault file and the data is gone. The threat model lists each claim and how to check it.
MIT
来源:README.md,提交 be6c38b
Full-text search over stored transactions. Each hit includes a receipt with the source file, line range, file SHA-256 and the raw line. Empty query lists the latest entries.
limitquerysinceuntilperiodaccountFetch one entry by id with its receipt.
id必填List accounts with entry counts, net total and date range.
无需输入参数。
Money in and out per account per month.
accountRe-hash every source file and compare each stored row with the file on disk. Also lists likely duplicates across overlapping exports.
无需输入参数。
Check running balances in the account's statements, and optionally compare the sum of entries with an expected balance.
as_ofaccount必填openingexpectedVault summary: path, counts and date range.
无需输入参数。
已满足适用检查项的 90%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
$ memvo search streamly2026-11-05 -17.99 checking STREAMLY SUBSCRIPTION, MONTHLY e_87f7eaf199f9cde5 checking.csv:72026-10-05 -15.99 checking STREAMLY SUBSCRIPTION, MONTHLY e_477cc512787183fc checking.csv:4$ memvo show e_87f7eaf199f9cde5e_87f7eaf199f9cde52026-11-05 -17.99 checkingSTREAMLY SUBSCRIPTION, MONTHLY
receipt source /home/me/statements/checking.csv (line 7) file sha256 7e61003a02cb6628f28bcbd0e17aba1cef8d823813df4f95324ecfc53c8bdbdb row sha256 6fe2f1f304317c9b9e6e96db7823ae80c72b38804c7ced445335d126a9a81ac5 raw 2026-11-05,"STREAMLY SUBSCRIPTION, MONTHLY",-17.99,4131.82vault ── accounts ── periods (YYYY-MM) ── entries ── receipt checking 2026-10 raw line, line range, savings 2026-11 file sha256, row sha256 brokerpip install memvo # pre-alphamemvo initmemvo democurl -s https://pypi.org/integrity/memvo/0.1.0a3/memvo-0.1.0a3-py3-none-any.whl/provenancememvo import ~/Downloads/checking.csv --account checkingmemvo import mutasi.csv --account tabungan # ; separators, 1.234,56 amounts, debet/kredit columnsmemvo import export.csv --account broker --kind broker --map amount=Netmemvo import download.qfx --account card # OFX/QFX is recognised from the content
memvo search rent # every hit carries its receiptmemvo search coffee --period 2026-11memvo show e_87f7eaf199f9cde5
memvo accountsmemvo periods --account checking
memvo audit # re-hash every source, check every rowmemvo reconcile --account checking --expect 4131.82memvo reconcile --account checking --expect statement # use the ledger balance in the newest OFX{ "mcpServers": { "memvo": { "command": "memvo", "args": ["mcp"] } }}python -m venv .venv && . .venv/bin/activatepip install -e '.[dev]'pytest --cov