An MCP (Model Context Protocol) server that enables AI assistants to manage personal finances through the Realbyte Money Manager application.
概览
An MCP server that lets AI assistants manage personal finances through the app's PC Manager web server. - — create, read, update, delete income & expenses - — manage accounts, balances, and cards - — move money between accounts - — period summaries and Excel export - — net-worth trends and portfolio breakdown - — stays logged in across restarts - — the server is now built on the FastMCP framework with Zod-validated tool inputs. Same 18 tools, same setup — just a smaller, cleaner, more maintainable codebase. - — removed dynamic code execution from the API response parser, locked Excel exports to your working directory (symlink-safe, atomic writes), retries limited to safe read operations, and all dependencies refreshed (npm audit: 0 known vulnerabilities). Node.js ≥ 22.13 is now required. - — the bundled testing-money-manager-mcp skill verifies every tool against a live Money Manager server with throwaway data and guaranteed cleanup. - ≥ 22.
README
以下为原文 README 节选，完整内容请查看原文。
Money Manager MCP Server
An MCP server that lets AI assistants manage personal finances through the Realbyte Money Manager app’s PC Manager web server.
✨ Features
- Full transaction CRUD — create, read, update, delete income & expenses
- Assets & credit cards — manage accounts, balances, and cards
- Transfers — move money between accounts
- Reports & export — period summaries and Excel export
- Dashboard — net-worth trends and portfolio breakdown
- Session persistence — stays logged in across restarts
🆕 What’s new in v2.0.0
- Migrated to FastMCP — the server is now built on the FastMCP framework with Zod-validated tool inputs. Same 18 tools, same setup — just a smaller, cleaner, more maintainable codebase.
- Security & supply-chain hardening — removed dynamic code execution from the API response parser, locked Excel exports to your working directory (symlink-safe, atomic writes), retries limited to safe read operations, and all dependencies refreshed (
npm audit: 0 known vulnerabilities). Node.js ≥ 22.13 is now required. - End-to-end testing skill for AI agents — the bundled
testing-money-manager-mcpskill verifies every tool against a live Money Manager server with throwaway data and guaranteed cleanup.
📦 Prerequisites
- Node.js ≥ 22.13
- The Money Manager app (Android) with its PC Manager web server running on the same Wi-Fi network as your computer. To start it: open the app → More (⋮) → PC Manager → Start, and note the displayed address (e.g.
192.168.1.1:8888) - An MCP-compatible client (Claude Desktop, VS Code with Copilot, Cursor, …)
🚀 Quick Start
Add the server to your AI client.
VS Code / GitHub Copilot
One-click install (prompts for the base URL):
安装
npx money-manager-mcp@latest --baseUrl http://YOUR_PHONE_IP:PORT配置
{
"mcpServers": {
"money-manager": {
"command": "npx",
"args": [
"money-manager-mcp@latest",
"--baseUrl",
"http://YOUR_PHONE_IP:PORT"
]
}
}
}