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 .