ランチマネー-MCP

ランチマネーMCPサーバー

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

これは何ですか？

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

特徴

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

get-recent-transactions : 過去 N 日間の最近の取引を表示します
search-transactions : 受取人名またはメモのキーワードで取引を検索します
get-category-spending : 特定のカテゴリの支出を分析する
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 :公式Node.jsウェブサイトからインストーラーをダウンロードして実行します。
Homebrew 搭載 Mac : ターミナルでbrew install node実行する
Linux : パッケージマネージャーを使用します (例: Ubuntu の場合はsudo apt install nodejs )

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

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

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

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）
取引には任意の日付範囲を使用できます
すべての金銭的価値は元の通貨で返されます

ライセンス

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

貢献

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

lunchmoney-mcp