YNAB MCP

YNAB MCP

Claude Code と You Need A Budget (YNAB) の統合のための YNAB Model Context Protocol (MCP) サーバー。

概要

このリポジトリには、Claude CodeがYNAB（You Need A Budget）アカウントと連携できるようにするDockerベースのMCPサーバーが含まれています。OAuthフローを実装し、予算管理、取引追跡、財務分析のための包括的なAPIを提供します。

特徴

• YNAB API を使用した OAuth ベースの認証
• 完全な予算とアカウント管理
• 取引の作成と分類
• 複数の予算（個人および家族）のサポート
• レート制限の処理（YNAB API 制限：200 リクエスト/時間）
• パフォーマンス向上のためのキャッシュ

はじめる

前提条件

• ドッカー
• Node.js v18+（開発用）
• クロード・コード CLI
• YNABアカウント

インストール

1. このリポジトリをクローンする
2. config/config.example.jsをconfig/config.jsにコピーし、YNAB API の認証情報を追加します。
3. Docker イメージをビルドします: docker build -t ynab-mcp:latest .
4. Claude の JSON 構成を作成します。
   { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest" ] }
5. Claude Code CLI を使用して MCP を登録します。
   claude mcp add-json ynab '{"command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest"]}'
   JSON をファイルに保存して使用することもできます。
   claude mcp add-json ynab "$(cat config.json)"
6. クロードの指示に従ってYNABアカウントで認証します

クロードとの統合

この MCP は Claude とシームレスに統合され、次のことが可能になります。

• 予算と取引の表示
• 財務分析の取得
• 自然な会話で予算を管理する

安全

• トークンはマウントされたDockerボリュームに安全に保存されます
• 機密データは記録されません
• 認証にはOAuth 2.0標準を使用します
• 読み取り専用モードのサポート

実装の詳細

実装は、以下を使用してモデル コンテキスト プロトコル標準に従います。

• Node.jsと公式MCP SDK
• コンテナ化とデプロイメントのためのDocker
• API 操作用の YNAB JavaScript SDK
• 認証のためのOAuth 2.0

ライセンス

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

謝辞

• YNAB API
• YNAB JavaScript ライブラリ
• 人類学的なクロード