MCP Ynab Server

🚀 MCP YNABサーバ

このサーバは、モデルコンテキストプロトコル（Model Context Protocol）を通じて、YNAB（You Need A Budget）の機能にアクセスできるMCPサーバの実装です。

✨ 主な機能

• アカウント残高と取引の確認
• 新しい取引の作成
• 標準化されたMCPリソースを通じたYNABデータへのアクセス

📦 インストール

uv pip install -e .

📚 ドキュメント

このサーバを動作させるには、YNAB APIキーが必要です。このキーは、YNAB開発者設定から取得できます。

APIキーは以下の方法で提供できます：

1. 環境変数：YNAB_API_KEY=your_api_key
2. MCPシークレット管理システム
3. プロジェクトのルートディレクトリにある.envファイル

💻 使用例

基本的な使用法

サーバの起動

# 開発モード、ホットリロードとブラウザ起動付き
task dev

# 本番環境用のインストール、Claude Desktop、Gooseまたはその他のMCP対応環境向け
task install

利用可能なリソース

• ynab://accounts - すべてのYNABアカウントをリスト表示
• ynab://transactions/{account_id} - 特定のアカウントの最近の取引を取得

利用可能なツール

• create_transaction - 新しい取引を作成
• get_account_balance - アカウントの現在の残高を取得

# 新しい取引を作成
result = await create_transaction(
    account_id="your_account_id",
    amount=42.50,  # 米ドルの金額
    payee_name="Coffee Shop",
    category_name="Dining Out",
    memo="Morning coffee"
)

# アカウントの残高を取得
balance = await get_account_balance("your_account_id")

# アカウントをリスト表示
accounts = await ctx.read_resource("ynab://accounts")

# 最近の取引を取得
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

高度な使用法

# 依存関係をインストール（uvを使用）
task deps

# すべてのテストを実行、統合テストも含む（YNAB APIキーが必要）
task test:all

# カバレッジレポートを生成
task coverage

# コードをフォーマットしてチェック
task fmt  # これをTaskfileに追加する必要があります

🔧 開発

このプロジェクトでは、Taskfileを使用して一般的な操作を管理しています。主要なコマンドは以下の通りです：

task dev       # 自動再読み込み付きで開発サーバを実行
task test      # 単体テストを実行
task coverage  # テストカバレッジレポートを生成
task install   # 本番環境用のバージョンをインストール
task deps      # 依存関係を同期

すべての利用可能なタスクについては、Taskfile.ymlを参照してください。