YNAB MCP

YNAB MCP

Сервер YNAB Model Context Protocol (MCP) для интеграции Claude Code с You Need A Budget (YNAB).

Обзор

Этот репозиторий содержит сервер MCP на базе Docker, который позволяет Claude Code взаимодействовать с учетными записями YNAB (You Need A Budget). Он реализует поток OAuth и предоставляет комплексный API для управления бюджетом, отслеживания транзакций и финансовой аналитики.

Известные проблемы

Доступность инструмента MCP

Были выявлены следующие проблемы:

1. API транзакций — конечная точка list_transactions завершается сбоем с ошибками «недопустимая дата» при использовании параметра sinceDate
2. Отсутствуют инструменты API . Несколько конечных точек, определенных в исходном коде, недоступны в интеграции MCP.
3. Непоследовательное поведение . Некоторые инструменты работают при тестировании с test-mcp.js, но не работают при фактической интеграции MCP.

Отслеживание проблем

Мы активно работаем над следующими исправлениями:

• Ветка fix-transactions-api : решение проблемы обработки формата даты в API транзакций
• Ветка fix-mcp-registration : обеспечение надлежащей регистрации и доступности всех инструментов API

Функции

• Аутентификация на основе OAuth с API YNAB
• Полное управление бюджетом и счетами
• Создание и категоризация транзакций
• Расширенное управление категориями с массовым распределением и рекомендациями
• Поддержка нескольких бюджетов (личных и семейных)
• Ограничение скорости обработки (лимит API YNAB: 200 запросов/час)
• Кэширование для повышения производительности

Новые функции управления категориями

Этот MCP включает в себя расширенные возможности управления категориями:

• Назначить категориям : распределить средства из категории «Готово к назначению» по нескольким категориям за одну операцию.
• Рекомендованные ассигнования : получите рекомендации на основе искусственного интеллекта по распределению бюджета на основе целей и моделей расходов.

Подробную информацию см. в документации по управлению категориями .

Начиная

Предпосылки

• Докер
• Node.js v18+ (для разработки)
• Клод Код CLI
• Счет YNAB

Установка

1. Клонировать этот репозиторий
2. Скопируйте config/config.example.js в config/config.js и добавьте свои учетные данные API YNAB.
3. Соберите образ Docker: docker build -t ynab-mcp:latest .
4. Создайте конфигурацию JSON для Клода:
   { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest" ] }
5. Зарегистрируйте MCP с помощью Claude Code CLI:
   claude mcp add-json ynab '{"command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest"]}'
   Вы также можете сохранить JSON в файл и использовать:
   claude mcp add-json ynab "$(cat config.json)"
6. Выполните аутентификацию с помощью своей учетной записи YNAB, когда Клод попросит об этом.

Интеграция с Клодом

Этот MCP легко интегрируется с Claude, что позволяет:

• Просмотр бюджетов и транзакций
• Получение финансовой информации
• Управление бюджетом посредством естественного разговора

Безопасность

• Токены надежно хранятся в смонтированном томе Docker.
• Никакие конфиденциальные данные не регистрируются.
• Аутентификация использует стандарты OAuth 2.0
• Поддержка режима «только чтение»

Подробности реализации

Реализация соответствует стандарту Model Context Protocol с использованием:

• Node.js и официальный MCP SDK
• Docker для контейнеризации и развертывания
• YNAB JavaScript SDK для операций API
• OAuth 2.0 для аутентификации

Лицензия

Массачусетский технологический институт

Благодарности

• API YNAB
• Библиотека JavaScript YNAB
• Антропный Клод