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 для управления бюджетом, отслеживания транзакций и финансовой аналитики.

Related MCP server: ynab-mcp

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

Доступность инструмента 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

• Антропный Клод