lunchmoney-mcp

ランチマネーMCPサーバー

Claude やその他の AI アシスタントを通じてLunchmoney の取引や予算を操作できるモデル コンテキスト プロトコル (MCP) サーバー。

これは何ですか？

このツールを使用すると、Lunchmoney の財務データを Claude AI に接続できるため、自然な会話を通じて支出について質問したり、予算を分析したり、財務に関する洞察を得たりすることができます。

特徴

このサーバーは、主に 4 つのツールを提供します。

1. get-recent-transactions : 過去 N 日間の最近の取引を表示します
2. search-transactions : 受取人名またはメモのキーワードで取引を検索します
3. get-category-spending : 特定のカテゴリの支出を分析する
4. get-budget-summary : 支出、残高、定期的な項目などの詳細な予算情報を取得します。

プライバシーとデータの取り扱い

重要： MCPは、プライバシーの境界を維持しながら、ClaudeがLunchmoneyデータを操作するための構造化された方法を提供します。以下の点にご注意ください。

• クロード（ホスト）は、ローカルMCPサーバーに接続するクライアントを作成します。
• Lunchmoney APIトークンはローカルマシンに残ります
• MCPサーバーはローカルで実行され、LunchmoneyのAPIからデータを取得します。
• Lunchmoneyデータへのアクセスには、各リクエストの承認が求められます。
• 財務について質問すると、クロードはMCPサーバーから特定の情報を要求します。
• MCPサーバーはリクエストをローカルで処理し、関連する結果のみを返します。
• クロードはあなたの財務データやAPIトークンに直接アクセスすることはできません。
• 要求された特定の情報（取引概要や予算状況など）のみがクロードと共有されます。
• Anthropicのデータ保持ポリシーは、会話の一部であるこれらの要約結果に適用されます。
• 各サーバー接続は分離されており、明確なセキュリティ境界が維持されています。

MCP の詳細については、次のドキュメントをご覧ください: https://modelcontextprotocol.io/introduction

インストール

Claude の公式ドキュメントもご覧ください: https://modelcontextprotocol.io/quickstart/user

npxの使用

Node.js は、コンピューター上 (Web ブラウザー外部) で JavaScript コードを実行できるソフトウェア プラットフォームです。

Node.js をインストールするには:

• Windows/Mac (https://nodejs.org/)からインストーラーをダウンロードして実行します。
• Homebrew 搭載 Mac : ターミナルでbrew install node実行する
• Linux : パッケージ マネージャーを使用します (例: Ubuntu の場合はsudo apt install nodejs )

Node.js をコンピューターにインストールすると、何もダウンロードせずにサーバーを直接実行できます。

1. Lunchmoney開発者設定からLunchmoney APIトークンを取得します
2. クロードデスクトップを開く
3. 設定→開発者→ Edit Config移動します
4. 次の構成を追加します。

your_token_here実際の Lunchmoney API トークンに置き換えます。

**重要な注意:**設定を変更した後、変更を有効にするには Claude Desktop を再起動する必要がある場合があります。

使用例

Claude Desktop で設定が完了すると、次のような質問をすることができます。

取引

• 「過去1週間の最近の取引を表示してください」
• 「Amazonでのすべての取引を検索」
• 「先月レストランにいくら使った？」
• 「経費としてタグ付けされた取引を検索する」

予算

• 「今月の予算の概要を見せてください」
• 「2024年1月から3月までの予算状況はどうなっていますか？」
• 「食費の予算はあといくら残っているの？」
• 「予算を超過しているカテゴリを表示」

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を標準化するオープンプロトコルです。MCPはAIアプリケーション用のUSB-Cポートのようなもので、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

MCP の主な利点は次のとおりです。

• LLMにデータと機能を公開するための標準化された方法
• 人間参加型セキュリティ（すべてのアクションにはユーザーの承認が必要）
• 構築済みの統合エコシステムの拡大
• 複数のAIモデルおよびアプリケーションで動作します

トラブルシューティング

Claude によると、MCP サーバーに接続できないそうです。

• Claudeの開発者設定の構成が正しいことを確認してください
• 設定を変更した後、Claude Desktopを再起動してみてください
• Lunchmoney APIトークンが有効であることを確認してください

Claude は Lunchmoney コマンドを認識しません:

• クロードで新しい会話を始める
• クエリで Lunchmoney を明示的に言及してみてください（例: 「最近の Lunchmoney 取引を表示」）

APIノート

• 予算データでは、日付の境界として月を使用する必要があります（例：2024-01-01 から 2024-01-31）
• 取引には任意の日付範囲を使用できます
• すべての金銭的価値は元の通貨で返されます

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。