Ynab MCP

🚀 YNAB MCP Server

このサーバーは、You Need A Budget (YNAB) とシームレスに統合するためのモデルコンテキストプロトコル (MCP) サーバーです。AIアシスタントがYNABの予算とやり取りできるようにし、強力な自動化と分析機能を提供します。

🚀 クイックスタート

📦 インストール

Claude Desktop でのクイックインストール

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here",
      }
    }
  }
}

オプションの環境変数:

"env": {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

uvx を使用する場合はインストール不要です。

# 直接実行 (推奨)
uvx ynab-mcp-server

# 特定のバージョンで実行
uvx ynab-mcp-server@0.1.1

開発用のインストール方法:

# ソースからクローンして実行
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

🔧 プラットフォーム別のセットアップ

Claude Desktop

1. 設定ファイルの場所を見つけます:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. YNAB MCPサーバーの設定を追加します:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

オプションの環境変数:

env: {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Goose

1. Gooseの設定を開きます。
2. MCPサーバーのセクションに移動します。
3. 新しいサーバーを追加します:
   • 名前: ynab-mcp
   • コマンド: uvx ynab-mcp-server
   • 環境変数:
     • YNAB_PAT: your_token_here

その他のプラットフォーム

他のMCP互換プラットフォームでは、以下のパラメータを使用して設定します:

• サーバー名: ynab-mcp
• コマンド: uvx
• 引数: ynab-mcp-server
• 必須環境変数: YNAB_PAT

⚙️ 設定

サーバーは環境変数を使用して設定できます。これらをプロジェクトのルートにある .env ファイルに配置するか、シェルで設定することができます。

YNABトークンの取得方法

1. YNABトークンの取得
   • YNAB開発者設定にアクセスします。
   • 新しいパーソナルアクセストークンを作成します。
   • トークンの値をコピーします。
2. 環境の設定 作業ディレクトリに .env ファイルを作成します:

YNAB_PAT="your_token_here"
YNAB_DEFAULT_BUDGET_ID="your_budget_id"
YNAB_READ_ONLY="true"

または、環境変数を直接設定します:

export YNAB_PAT="your_token_here"

✨ 主な機能

• 完全な予算管理

  • 複数の予算を表示および管理する
  • 口座残高と取引を追跡する
  • カテゴリの支出と目標を監視する

• 取引管理

  • 取引を一覧表示および検索する
  • 取引の詳細を更新する
  • 支払先とカテゴリを管理する

• 財務分析

  • 包括的な財務概要を取得する
  • 支出パターンを追跡する
  • 予算の進捗を監視する

💻 使用例

利用可能なツール

サーバーは、YNABデータとやり取りするための一連のツールを提供します。説明は、各ツールの目的と推奨される使用方法を説明しています。

🔧 技術詳細

開発

ローカルセットアップ

1. リポジトリをクローンします:

git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server

2. 依存関係をインストールします:

uv sync

3. サーバーを実行します:

uv run ynab-mcp-server

デバッグ

MCPインスペクターを使用してデバッグします:

npx @modelcontextprotocol/inspector uvx ynab-mcp-server

ローカル開発デバッグ用:

cd path/to/ynab-mcp-server
npx @modelcontextprotocol/inspector uv run ynab-mcp-server

また、以下のコマンドでログを表示することもできます:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

ビルドと公開

# パッケージをビルド
uv build

# PyPIに公開
uv publish

🤝 コントリビューション

コントリビューションは大歓迎です！以下の手順で支援できます:

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを開きます。

PRが以下のことを確認してください:

• 既存のコードスタイルに従っている
• 適切なテストを含んでいる
• 必要に応じてドキュメントを更新している

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• YNAB API のコア機能の提供
• Model Context Protocol のAIアシスタント統合の実現