MCP Ynab

🚀 MCP 予算アシスタントサーバー 💰

このプロジェクトは、YNAB（TypeScript バージョン）の MCP サーバーです！🎉 これにより、Cursor（またはその他の MCP クライアント）を You Need A Budget (YNAB) アカウントに接続し、エディターから直接財務データとやり取りすることができます。

🚀 クイックスタート

このサーバーの概要

このサーバーは、モデルコンテキストプロトコル (MCP) の TypeScript 実装で、YNAB 公式 API とのブリッジとして機能します。MCP 互換環境に標準化されたツールを提供し、AI アシスタント（Cursor など）から YNAB データを読み書きし、財務問題を解決するのを支援します。

提供されるツール 🛠️

このサーバーは以下のツールを提供しており、それぞれ詳細なドキュメントがあります。

• listBudgets：利用可能な予算を一覧表示します。
• listAccounts：指定した予算内のアカウントを一覧表示します。
• getAccountBalance：特定のアカウントの現在の残高を取得します。
• listCategories：指定した予算内のカテゴリを一覧表示します。
• getCategoryInfo：特定の月の特定のカテゴリの詳細情報を取得します。
• getBudgetSummary：特定の月の予算概要（収入、予算額、活動）を提供します。
• listTransactions：予算の取引を、フィルタオプション（アカウント、カテゴリ、日付など）付きで一覧表示します。
• createTransaction：予算内に新しい取引または仕訳を作成します。

各ツールの README.md を参照して、パラメータ、出力、使用コンテキストの詳細を確認してください。

セットアップ 🚀

1. リポジトリをクローンする：

   # まだクローンしていない場合
   git clone https://github.com/Bulletninja/mcp-ynab
   cd mcp-ynab
   

2. 依存関係をインストールする：

   npm install
   

3. YNAB API トークンを設定する：

   • config.json ファイルに YNAB API トークンを追加します。

     {
       "ynabToken": "your_ynab_api_token_here"
     }
     

4. サーバーを起動する：

   npm start
   

使用方法

MCP サーバーを有効にする

Cursor で MCP サーバーを有効にするには、以下の手順を実行します。

1. config.json ファイルを開きます。
2. 以下の設定を追加します。

   {
     "mcpServers": [
       {
         "name": "YNAB",
         "executablePath": "dist/server.js"
       }
     ]
   }
   

3. Cursor を起動すると、サーバーがバックグラウンドで実行されます。

ツールを呼び出す

ターミナルで以下のコマンドを入力してツールを呼び出します。

node dist/server.js [ツール名]
例：
node dist/server.js list-budgets

📚 ドキュメント

各ツールの詳細なドキュメントは、それぞれのツールの README.md ファイルに記載されています。

🔧 技術詳細

このサーバーは、TypeScript で実装されており、MCP プロトコルを使用して YNAB API と通信します。

📄 ライセンス

このプロジェクトのライセンスに関する情報は、リポジトリ内の LICENSE ファイルを参照してください。

5. 開発情報