Moneywiz MCP

🚀 MoneyWiz MCP Server

MoneyWizのデータベースデータにアクセスするためのMCP（Model Context Protocol）サーバーです。このサーバーを使用すると、ChatGPTやClaudeなどのMCP互換クライアントが、MoneyWizの財務データを照会し、支出と収入の傾向を分析し、貯蓄の推奨事項を取得し、純資産を計算し、包括的な財務統計を表示できます。

✨ 主な機能

• 口座の一覧表示：残高と通貨を含むすべての口座を取得します。
• 口座残高の取得：特定の口座の残高を取得します。
• 取引の一覧表示：最近の取引を表示し、必要に応じて口座でフィルタリングできます。
• カテゴリの一覧表示：すべての支出/収入カテゴリを取得します。
• 支出傾向の分析：カテゴリと期間（月/年）ごとに支出傾向を分析します。
• 収入傾向の分析：カテゴリと期間（月/年）ごとに収入傾向を分析します。
• 貯蓄の推奨事項の取得：収入と支出の比較に基づいて、個人向けの貯蓄の推奨事項を取得します。
• 純資産の計算：すべての口座から総純資産を計算します（資産 - 負債）。
• 財務統計の取得：すべての履歴データから包括的な財務統計を取得します。

📦 インストール

1. このリポジトリをクローンします。

git clone <repository-url>
cd moneywiz-mcp

2. サーバーをビルドします。

go build -o moneywiz-mcp ./cmd/main.go

3. MoneyWizのデータベースをエクスポートします。
   • MoneyWizアプリを開きます。
   • 設定 → データベースとエクスポート → データベースファイルをエクスポート と進みます。
   • これにより、SQLiteデータベースファイル (ipadMoneyWiz.sqlite) を含むフォルダ（例： iMoneyWiz-Data-Backup-2025_12_21-17_23）が作成されます。

💻 使用例

サーバーの起動

サーバーは、コマンドライン引数でデータベースのパスを指定して起動できます。

./moneywiz-mcp -db /path/to/iMoneyWiz-Data-Backup-2025_12_21-17_23

または、データベースフォルダが現在のディレクトリにある場合：

./moneywiz-mcp -db ./iMoneyWiz-Data-Backup-2025_12_21-17_23

サーバーは、指定されたフォルダ内の ipadMoneyWiz.sqlite を自動的に探します。

⚠️ 重要提示

最初にMoneyWizからデータベースをエクスポートする必要があります（設定 → データベースとエクスポート → データベースファイルをエクスポート）。

MCPクライアントの設定

このサーバーをMCPクライアント（Claude Desktopなど）で使用するには、MCP設定ファイルに追加します。

クイックセットアップ（推奨）

セットアップスクリプトを実行します。

./setup.sh

これにより、Claude Desktopが正しいパスで自動的に設定されます。

手動設定

Claude Desktopの設定

{
  "mcpServers": {
    "moneywiz": {
      "command": "moneywiz-mcp/moneywiz-mcp",
      "args": ["-db", "moneywiz-mcp/iMoneyWiz-Data-Backup-2025_12_21-17_23"]
    }
  }
}

⚠️ 重要提示

パスを実際の絶対パスに置き換えてください。

設定を更新した後：

1. Claude Desktopを完全に終了します（⌘Q）。
2. Claude Desktopを再開します。
3. MCPサーバーが自動的に接続されます。

詳細なセットアップ手順については、SETUP.md を参照してください。

利用可能なツール

list_accounts

MoneyWiz内のすべての口座とその残高および通貨を一覧表示します。 パラメータ：なし 例：

{
  "name": "list_accounts",
  "arguments": {}
}

get_account_balance

IDで特定の口座の残高を取得します。 パラメータ：

• account_id（整数、必須）：口座のID 例：

{
  "name": "get_account_balance",
  "arguments": {
    "account_id": 249
  }
}

list_transactions

最近の取引を一覧表示し、必要に応じて口座IDでフィルタリングできます。 パラメータ：

• account_id（整数、オプション）：取引をフィルタリングする口座ID。指定しない場合は、すべての取引が返されます。
• limit（整数、オプション）：返される取引の最大数（デフォルト：50） 例：

{
  "name": "list_transactions",
  "arguments": {
    "account_id": 249,
    "limit": 20
  }
}

list_categories

MoneyWiz内のすべてのカテゴリを一覧表示します。 パラメータ：なし 例：

{
  "name": "list_categories",
  "arguments": {}
}

analyze_spending_trends

カテゴリと期間ごとに支出傾向を分析します。支出を月または年ごとにグループ化し、カテゴリ別の内訳を提供します。 パラメータ：

• group_by（文字列、オプション）："month" または "year" でグループ化（デフォルト："month"）
• months（整数、オプション）：分析する月数（デフォルト：6） 例：

{
  "name": "analyze_spending_trends",
  "arguments": {
    "group_by": "month",
    "months": 6
  }
}

返り値：支出傾向の配列で、以下の項目を含みます。

• period：期間（YYYY-MMまたはYYYY）
• total_spending：その期間の総支出
• transaction_count：取引の数
• by_category：カテゴリ名と支出額のマップ

analyze_income_trends

カテゴリと期間ごとに収入傾向を分析します。収入を月または年ごとにグループ化し、カテゴリ別の内訳を提供します。 パラメータ：

• group_by（文字列、オプション）："month" または "year" でグループ化（デフォルト："month"）
• months（整数、オプション）：分析する月数（デフォルト：6） 例：

{
  "name": "analyze_income_trends",
  "arguments": {
    "group_by": "year",
    "months": 12
  }
}

返り値：収入傾向の配列で、以下の項目を含みます。

• period：期間（YYYY-MMまたはYYYY）
• total_income：その期間の総収入
• transaction_count：取引の数
• by_category：カテゴリ名と収入額のマップ

get_savings_recommendations

収入と支出を分析し、個人向けの貯蓄の推奨事項を取得します。財務パターンに基づいた実行可能なアドバイスを提供します。 パラメータ：

• months（整数、オプション）：分析する月数（デフォルト：6） 例：

{
  "name": "get_savings_recommendations",
  "arguments": {
    "months": 6
  }
}

返り値：貯蓄分析で、以下の項目を含みます。

• period：分析期間の説明
• total_income：その期間の総収入
• total_spending：その期間の総支出
• net_savings：純貯蓄（収入 - 支出）
• savings_rate：貯蓄率（パーセント）
• average_monthly_income：月平均収入
• average_monthly_spending：月平均支出
• top_spending_categories：上位5つの支出カテゴリとその割合
• recommendations：推奨事項の配列で、以下の項目を含みます。
  • type："warning"、"suggestion"、または "positive"
  • title：推奨事項のタイトル
  • description：詳細な推奨事項
  • priority："high"、"medium"、または "low"
  • impact：潜在的な貯蓄額

calculate_net_worth

すべての口座から総純資産を計算します。すべての口座残高の合計（資産 - 負債）を求めます。 パラメータ：なし 例：

{
  "name": "calculate_net_worth",
  "arguments": {}
}

返り値：純資産の計算結果で、以下の項目を含みます。

• total_assets：すべての正の口座残高の合計
• total_liabilities：すべての負の口座残高の合計（正の値として）
• net_worth：総資産 - 総負債
• account_count：含まれる口座の数
• by_currency：通貨別の純資産の内訳
• accounts：残高を含むすべての口座の配列

get_financial_stats

すべての履歴データから包括的な財務統計を取得します。概要メトリクスと年別の内訳を提供します。 パラメータ：なし 例：

{
  "name": "get_financial_stats",
  "arguments": {}
}

返り値：財務統計で、以下の項目を含みます。

• total_transactions：総取引数（全期間）
• income_transactions：収入取引の数
• expense_transactions：支出取引の数
• total_income：総収入（全期間）
• total_spending：総支出（全期間）
• net_savings：純貯蓄（全期間）
• average_transaction：平均取引額
• largest_income：最大の単一収入取引
• largest_expense：最大の単一支出取引
• account_count：総口座数
• category_count：総カテゴリ数
• first_transaction_date：最初の取引の日付
• last_transaction_date：最後の取引の日付
• date_range：フォーマットされた日付範囲の文字列
• by_year：年別の統計のマップで、以下の項目を含みます。
  • year：年（YYYY）
  • income：その年の総収入
  • spending：その年の総支出
  • net_savings：その年の純貯蓄
  • transaction_count：その年の取引数

🔧 技術詳細

データベース構造

このサーバーは、MoneyWizのSQLiteデータベース (ipadMoneyWiz.sqlite) にアクセスします。データベースはCore Dataのエンティティ - 属性 - 値モデルを使用しており、ほとんどのオブジェクトは ZSYNCOBJECT テーブルに異なるエンティティタイプ (Z_ENT) で格納されています。

• エンティティ10、11、12、13、15、16：口座（さまざまなタイプ）
• エンティティ37、45、46、47：通常の取引
• エンティティ43：振替取引
• エンティティ19：カテゴリ

重要な注意事項

• 日付：取引日付はCore Dataのタイムスタンプ（2001-01-01 UTCからの秒数）として格納され、自動的にISO形式に変換されます。
• 残高：口座残高は ZBALLANCE（二重のLに注意）に格納されます。残高が0またはNULLの場合、開始残高 + 取引から計算されます。
• 取引：収入取引は正の ZAMOUNT1 を持ち、支出取引は負の ZAMOUNT1 を持ちます。
• カテゴリ：カテゴリは ZCATEGORYASSIGMENT テーブルを介して取引にリンクされています。

開発

プロジェクト構造

moneywiz-mcp/
├── cmd/
│   └── main.go          # メインエントリポイント
├── internal/
│   ├── database/        # データベースアクセス層
│   │   └── database.go
│   └── server/          # MCPサーバーの実装
│       └── server.go
├── go.mod
└── README.md

ビルド

go build -o moneywiz-mcp ./cmd/main.go

依存関係

• github.com/mark3labs/mcp-go - MCPサーバーライブラリ
• github.com/mattn/go-sqlite3 - SQLiteドライバ

📄 ライセンス

詳細については、LICENSEファイルを参照してください。