Lunchmoney MCP Server

Lunchmoney MCP サーバー

Claude やその他の AI アシスタントを通じて、Lunchmoney の取引や予算を操作できる Model Context Protocol (MCP) サーバーです。

これは何ですか？

このツールは、Lunchmoney の財務データを Claude AI に接続するためのものです。これにより、支出に関する質問をしたり、予算を分析したり、自然な会話を通じて財務に関するインサイトを得たりすることができます。

機能

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

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

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

重要: MCP は、プライバシーの境界を維持しながら、Claude が Lunchmoney のデータを操作するための構造化された方法を提供します。知っておくべきことは次のとおりです。

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

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

インストール

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

npx を使用する

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

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

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

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

1. Lunchmoney 開発者設定 から Lunchmoney API トークンを取得します
2. Claude Desktop を開きます
3. 設定 → 開発者 → Edit Config に移動します
4. 次の設定を追加します:

{
  "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 とは？

Model Context Protocol (MCP) は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は AI アプリケーションにおける USB-C ポートのようなものだと考えてください。AI モデルをさまざまなデータソースやツールに接続するための標準的な手段を提供します。

MCP の主なメリット:

• LLM にデータと機能を公開するための標準的な手段
• ヒューマン・イン・ザ・ループによるセキュリティ（すべてのアクションにはユーザーの承認が必要）
• 事前構築された統合のエコシステムが拡大中
• 複数の AI モデルとアプリケーションで動作

トラブルシューティング

Claude が MCP サーバーに接続できないと表示する:

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

Claude が Lunchmoney コマンドを認識しない:

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

API に関する注意

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

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送ってください。