shahlaukik/money-manager-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

20 stars 5 forks 品質 78 トレンド 37MIT

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-mcp skill 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):

GitHub で README 全文を見る

インストール

npx money-manager-mcp@latest --baseUrl http://YOUR_PHONE_IP:PORT

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "money-manager": {
      "command": "npx",
      "args": [
        "money-manager-mcp@latest",
        "--baseUrl",
        "http://YOUR_PHONE_IP:PORT"
      ]
    }
  }
}