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 ライブラリ

• 人類学的なクロード