MCP YNAB-сервер

Реализация сервера MCP, которая обеспечивает доступ к функциональности YNAB (You Need A Budget) через протокол контекста модели.

Функции

Просмотр остатков на счетах и транзакций
Создать новые транзакции
Доступ к данным YNAB через стандартизированные ресурсы MCP

Related MCP server: YNAB MCP Server

Установка

uv pip install -e .

Конфигурация

Для работы сервера требуется ключ API YNAB. Вы можете получить его в настройках разработчика YNAB .

Ключ API можно предоставить через:

Переменная среды: YNAB_API_KEY=your_api_key
Система управления секретами MCP
Файл .env в корне проекта

Использование

Запуск сервера

# Development mode with hot reload and browser launch
task dev

# Production install for Claude Desktop, Goose, or any other MCP-supported environment
task install

Доступные ресурсы

ynab://accounts — список всех учетных записей YNAB.
ynab://transactions/{account_id} — Получить последние транзакции для определенного счета

Доступные инструменты

create_transaction — Создать новую транзакцию
get_account_balance - Получить текущий баланс счета

Пример использования

# Create a new transaction
result = await create_transaction(
    account_id="your_account_id",
    amount=42.50,  # in dollars
    payee_name="Coffee Shop",
    category_name="Dining Out",
    memo="Morning coffee"
)

# Get account balance
balance = await get_account_balance("your_account_id")

# List accounts
accounts = await ctx.read_resource("ynab://accounts")

# Get recent transactions
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

Разработка

# Install dependencies (uses uv)
task deps

# Run all tests including integration tests (you will need a YNAB API key for this)
task test:all

# Generate coverage report
task coverage

# Format and lint code
task fmt  # Should add this to Taskfile

Задачи проекта

Этот проект использует Taskfile для общих операций. Ключевые команды:

task dev       # Start dev server with auto-reload
task test      # Run unit tests
task coverage  # Generate test coverage report
task install   # Install production build
task deps      # Synchronize dependencies

Все доступные задачи см. в Taskfile.yml .