mcpField
A
avenir-mcp

avenir-mcp

ローカル
avenir-mcp.pages.dev金融データ41 日前に更新
リポジトリ公式サイト

avenir-mcp について

avenir-mcpは、AIエージェントで個人のYNAB予算を確認し、計画を立てるための非公式MCPサーバーです。既定では読み取り専用で、変更を有効にした場合も確認が必要で、取り消せます。

主な機能

  1. 01月次予算の概要確認
  2. 02残高予測と債務返済計画
  3. 03取引検索とカテゴリ提案
  4. 04口座の照合
  5. 05予算変更のプレビュー、確認、取り消し

活用シーン

  1. 01当月に超過したカテゴリの特定
  2. 02残高がゼロ未満になるかの予測
  3. 03保留中の取引のカテゴリ確認
  4. 04取り消し可能な状態で予算カテゴリ間の資金移動

MCP 対応

MCPクライアントにYNABの予算閲覧・計画ツールを提供します。既定では書き込みツールを登録せず、有効にした場合も変更には確認が必要で、undo_operationで元に戻せます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mathbeal-avenir": {
      "command": "uvx",
      "args": [
        "avenir-mcp"
      ],
      "env": {
        "YNAB_API_KEY": "<YNAB_API_KEY>",
        "AVENIR_MCP_WRITE": "<AVENIR_MCP_WRITE>"
      }
    }
  }
}
起動コマンドuvx avenir-mcp
設定が必要な環境変数
YNAB_API_KEYシークレットYour YNAB personal access token (YNAB > Account settings > Developer settings).
AVENIR_MCP_WRITESet to 1 to expose the write tools; read-only otherwise.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiavenir-mcp0.8.0

ツール

19

掲載時のツール一覧 · 3 日前に更新

パラメーター型必須説明
untilstringはい予測の最終月。形式は YYYY-MM、最大 24 か月先まで。
plan_idstringはいYNAB のプラン ID または 'last-used'。
one_offsanyいいえ予想される一時的な金額：{date YYYY-MM-DD, amount, label}。YNAB ですでに予定されている金額は含めないでください（それらは計上されます）。
account_idsanyいいえ対象に含める口座（list_accounts から指定）。デフォルトでは、すべての未閉鎖の予算対象口座。
monthly_incomeanyいいえ毎月の予想収入。履歴（定期収入または平均値）および YNAB の予定取引から得られる収入に置き換わります。デフォルトでは表示された値を使用します。
variable_monthlyanyいいえ定期的な請求以外の月間支出（負数）。デフォルトは過去 3 か月の平均です。

詳細

avenir-mcp：YNAB 向け非公式 MCP サーバー

🇬🇧 avenir-mcp（avenir はフランス語で「未来」を意味します）は、AI エージェントが YNAB のプランを読み取り、 次に何をすべきかの計画を支援します。

🇫🇷 avenir-mcp は、AI エージェントが YNAB のプランを読み取り、 次に何をすべきかの準備を支援します。

Works with YNAB PyPI avenir-mcp on Glama Mentioned in Awesome MCP Servers ライセンス 品質 MCP Inspector ミューテーション ドキュメント YNAB API 規約：自己チェック済み カバレッジ 型 docstrings コードスタイル Python OpenSSF ベストプラクティス 最終コミット

Claude、または任意の MCP クライアントに、普段の言葉でプランについて質問できます。 デフォルトでは読み取り専用です。変更はすべて事前にプレビューされ、あなたの確認後に適用され、元に戻すこともできます。

インストール

YNAB の個人用アクセストークンが必要です。YNAB → Account Settings → Developer Settings → New Token の順に進んでください。

Claude Desktop 用にダウンロード

Claude Desktop、ターミナル不要：ボタンからダウンロードしたファイルを Settings → Extensions にドロップし、その画面でトークンを貼り付けてください。

Claude Code、トークンを含むコマンドを 1 つ実行するだけです：

claude mcp add avenir-mcp --env YNAB_API_KEY=your-token -- uvx avenir-mcp

どちらも読み取り専用でインストールされます。Cursor、LM Studio、VS Code、Windows、プランの変更 （AVENIR_MCP_WRITE=1）、その他すべてのオプションについては、以下をご覧ください： インストール · 設定。

30 秒で完了する会話です。今月の状況と、余裕のあるカテゴリを尋ねると、エージェントは 4 つの読み取り専用ツール（月次サマリー、すべてのカテゴリ、予算と支出、過去 3 か月）を同時に呼び出します。エージェントは、予算超過しているのはレストランだけであると回答します。支出額は 166.50、利用可能額は 144.00（予算 120.00 ＋ 前月からの繰越 24.00）で、138.8％、利用可能額は −22.50 です。また、過去 3 か月の支出が 113.70 → 119.90 → 166.50 と増加したこと、テニスに 80.00、食料品に 411.90 の余裕があることも伝えます。まだ何も使っていないテニスから 22.50 を補填することを提案します。ユーザーが「テニスから補填して」と答えると、move_money は何も変更しないプレビューを表示します。テニスの予算は 80.00 → 57.50、レストランの予算は 120.00 → 142.50、利用可能額は −22.50 → 0.00 となり、予算内に収まります。キャンセルボタンと確定ボタンがあり、確定するまで変更は適用されず、適用後も元に戻せるという注意書きが表示されます。

▶ 20 秒の紹介を見る

デモプランでの get_net_worth_trend：過去 18 か月で、自動車ローンの利息があるにもかかわらず負債は 27,198 から 19,041 に減少し、資産は増加、純資産は −24,038 から +1,230 に上昇しています。車の修理時とクリスマスには一時的な落ち込みがあります。

どちらも架空のデモプランから生成され、python -m docsgen によって再生されたものです。すべての数値は、avenir-mcp が現在回答する内容です。

質問できること

  • 今月の状況を把握する — 「今月、予算オーバーしているカテゴリはどれですか？」→ get_monthly_summary
  • 支出を見通す — 「12月までに残高がマイナスになりますか？」→ forecast_balance
  • 借金を返済する — 「毎月500を返済に充てた場合、借金はいつ完済できますか？」→ get_debt_payoff_plan
  • 取引を整理する — 「保留中の取引をカテゴリ分けしてください。」→ suggest_categories。承認後に適用されます
  • 取引を探す — 「12日の86.40のレシートはどの取引ですか？」→ find_transactions
  • 口座を照合する — 「銀行の残高は3,440.80です。YNABの残高と一致しますか？」→ reconcile_account
  • 内容を変更する — 「テニスからレストランに30を移してください。」→ move_money。プレビューと確認の後に実行され、undo_operation で元に戻せます

実際の回答例を含む、すべてのツール： リファレンス · ユースケース。

質問が見つかりませんか？アイデアがありますか？ 予算に聞いてみたい質問を Discussions → Ideasでお知らせください。 avenir-mcp の使い方については、 Discussions → Q&Aをご覧ください。 実際の金額、実際の口座、トークンは絶対に投稿しないでください。

avenir-mcp の特長

  • エンドポイントではなく、タスクのためのツールです。 1つのツールで月の状況を分析し、別のツールで口座を照合します。
  • デフォルトでは読み取り専用です。 プランを変更するツールは、有効にした場合にのみ登録されます。
  • プレビュー、確認、取り消しができます。 書き込み操作は承認を待ってから実行され、undo_operation で元に戻せます。
  • エージェントが読み取れる回答を返します。 通貨単位を明示し、回答を型付けし、銀行のテキストを信頼できないデータとして扱います。
  • 検証済みです。 行と分岐のカバレッジは100％で、架空のプランを使った実際のエージェントテストは25/25です。
今月の予算状況を尋ねると、エージェントは2つの読み取り専用ツールで月の状況を確認し、「予算超過のカテゴリは1つで、レストランが22.50超過しています。それ以外はすべて順調です」と回答します。 デモ用プランでのforecast_balance：月末残高は今月から3か月先まで増加しています。各月の最低残高となる日と、来月に予定されている年払いの保険料も表示されます。

📖 ドキュメント：https://avenir-mcp.pages.dev/avenir-mcp/ · English · Français · Español · Deutsch · Nederlands

Claude Code プラグイン

plugin/ は avenir-mcp を Claude Code プラグインとして提供します。Claude Code がトークンを要求し、トークンを表示せずに保持して、プラグイン専用のロックされた環境からサーバーを起動します。クローンからは次のように実行します。 claude --plugin-dir plugin.

プラグインの動作内容
実行uv run --locked --project プラグインのフォルダー を実行します。リリース用の plugin/pyproject.toml が固定するものだけを起動します。独自のスクリプトも、ビルド手順も、フックも、シェルもありません
接続初回は、リリースと plugin/uv.lock が固定するバージョンをインストールするために pypi.org と files.pythonhosted.org に接続します。その後は、avenir-mcp が常に行うとおり、トークンを使って api.ynab.com に接続します
書き込みuv がプラグインのフォルダー内に解決する環境と、uv 自身のキャッシュのみです。それ以外の場所には書き込みません
プランへの変更ありません。avenir-mcp は読み取り専用で起動します。AVENIR_MCP_WRITE は設定されないため、プランを変更するツールは登録されません

開発

git clone https://github.com/mathbeal/avenir-mcp && cd avenir-mcp
uv sync
just check        # lint, types, tests at 100 % coverage, vocabulary, lockfile
just docs-serve   # the documentation, live
just evaluate     # a real agent on the demo plan (uses your Claude plan)

プルリクエストを作成する前に、AGENTS.md と CONTRIBUTING.md をお読みください。セキュリティに関する報告については、SECURITY.md をご覧ください。その他の資料：ARCHITECTURE.md、ROADMAP.md、GOVERNANCE.md、および行動規範。

YNAB の API v1.87.0 を対象にビルドおよびテストされています。毎週実行される YNAB API drift チェックは、YNAB が新しいバージョンを公開すると失敗します。変更のたびに、2025-05-28 時点の YNAB API 利用規約（名称、帰属表示、YNAB 独自の画像、所有者本人のみが使う個人用トークン、1 時間あたりの上限）に準拠しているかを自己確認しています。規約が変更されると、毎週実行されるジョブによってバッジが赤くなります。

プライバシーポリシー

avenir-mcp は自分で実行するプログラムであり、サービスではありません。公開者はサーバーを運用せず、あなたのデータを受け取ることもありません。トークンは環境から読み込まれ、秘密値としてメモリ内に保持され、YNAB にのみ送信されます。ツールが必要とする際にプランのデータが取得され、エージェントに返されるため、MCP クライアントの背後にあるモデルプロバイダーもそのデータを参照します。取り扱う情報、保持期間、消去方法については、こちらをご覧ください。 https://avenir-mcp.pages.dev/avenir-mcp/project/privacy/.

ライセンス

MIT。

非公式プロジェクト

私たちは YNAB またはその子会社や関連会社とは提携、関係、その他いかなる形でも公式につながりはありません。YNAB の公式ウェブサイトは https://www.ynab.com です。YNAB および You Need A Budget という名称のほか、関連する名称、商号、標章、商標、エンブレム、画像は、YNAB の登録商標です。これらの名称は、avenir-mcp が連携するサービスを示す目的でのみ記載しています。サードパーティ製アプリとして、YNAB の Works with YNAB ディレクトリに掲載されています。YNAB の推奨を受けたものではありません。

avenir-mcp は、自分のマシン上で、自分自身の YNAB トークンを使って個人利用するためのものです。公開サーバーまたは共有サーバーとしての実行はサポートされていません。本ソフトウェアは現状有姿で提供され、保証はありません。また、金融上の助言ではありません。確定した変更については、引き続きご自身が責任を負います。法的通知をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。