MCP-сервер для отслеживания финансов

Анализ личных финансов с помощью ИИ Claude и протокола Model Context Protocol (MCP).

Что это делает

Этот MCP-сервер подключает Claude AI к данным о финансовых транзакциях, позволяя делать запросы о ваших финансах на естественном языке:

• "Покажи мои расходы за этот месяц"

• "Найди все мои подписки"

• "Каковы были мои 10 крупнейших расходов?"

• "Покажи тенденции расходов за последние 3 месяца"

• "Найди все транзакции Starbucks"

• "Проверь мой бюджет: Питание $500, Покупки $300"

Related MCP server: My Finance MCP Server

Возможности

• 6 инструментов финансового анализа

  • Сводки ежемесячных расходов

  • Обнаружение подписок (регулярных платежей)

  • Отслеживание бюджета и оповещения

  • Анализ тенденций расходов

  • Рейтинг крупнейших расходов

  • Поиск транзакций

• Интеграция с Plaid

  • Подключение к 10 000+ банков (песочница для тестирования)

  • Данные о транзакциях в реальном времени (при подключении к реальным счетам)

  • Безопасный доступ через API

• Приоритет конфиденциальности

  • Все данные остаются локально на вашем компьютере

  • Нет внешнего хранилища данных

  • Зашифрованные API-соединения

Быстрый старт

Предварительные требования

• Python 3.9 или выше

• Приложение Claude Desktop

• Аккаунт Plaid (бесплатно на https://dashboard.plaid.com)

Установка

1. Клонируйте репозиторий

   git clone https://github.com/yourusername/finance-plaid-mcp.git
   cd finance-plaid-mcp

2. Создайте виртуальное окружение

   python -m venv venv
   
   # Activate it:
   # Windows:
   venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. Установите зависимости

   pip install -r requirements.txt

4. Настройте ключи API Plaid

   Скопируйте .env.example в .env и добавьте свои ключи Plaid с сайта https://dashboard.plaid.com

   PLAID_CLIENT_ID=your_client_id_here
   PLAID_SECRET=your_sandbox_secret_here
   PLAID_ENV=sandbox
   DATA_DIR=./data

5. Сгенерируйте примеры данных (для тестирования)

   python generate_sample_data.py

6. Настройте Claude Desktop

   Добавьте это в файл конфигурации Claude Desktop:

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "finance-tracker": {
         "command": "python",
         "args": [
           "/FULL/PATH/TO/finance-plaid-mcp/src/server.py"
         ]
       }
     }
   }

Важно: Используйте полный абсолютный путь к вашему проекту!

7. Перезапустите Claude Desktop

8. Протестируйте!

   В Claude спросите: "Найди все мои подписки"

📁 Структура проекта

finance-plaid-mcp/ ├── src/ │ ├── server.py # MCP-сервер (основная точка входа) │ ├── plaid_client.py # Интеграция с API Plaid │ ├── analyzer.py # Логика анализа транзакций │ └── config.py # Конфигурация и переменные окружения ├── data/ │ └── sample_transactions.json # Сгенерированные тестовые данные ├── screenshot.png # Скриншот демонстрации ├── .env # Ваши ключи API (НЕ добавлять в git) ├── .env.example # Шаблон для ключей API ├── .gitignore # Предотвращает коммит секретов ├── requirements.txt # Зависимости Python └── README.md # Этот файл

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

Claude может вызывать эти инструменты при анализе ваших финансов:

🏦 Подключение реальных банковских счетов

В настоящее время в режиме песочницы (Sandbox) (только тестовые данные)

Чтобы подключить реальные банки:

1. Переключитесь в режим Development в панели управления Plaid

2. Обновите .env: PLAID_ENV=development

3. Реализуйте Plaid Link UI (веб-интерфейс для входа в банк)

Для портфолио/демонстрации рекомендуется режим песочницы, чтобы избежать раскрытия реальных финансовых данных.

📊 Пример вывода

Поиск подписок: Найдено 19 подписок на общую сумму $18 123/год Топ подписок:

Comcast Internet: $130.71/мес ($915 всего) Apple Store: $180.05/мес ($900 всего) Verizon Phone Bill: $110.75/мес ($886 всего) Electric Bill: $119.86/мес ($839 всего) Zara: $151.91/мес ($760 всего)

Ежемесячная сводка: Итого за месяц: $1 510 Доход: $5 000 Расходы: $3 490 Чистая прибыль: $1 510 Расходы по категориям:

Продукты: $644 Покупки: $900 Коммунальные услуги: $886 Питание: $450 Транспорт: $380

🛠️ Технологический стек

• Python 3.14

• MCP SDK - Протокол Model Context Protocol

• Plaid API - Подключение к банку и данные о транзакциях

• Pandas - Анализ данных

• Claude AI - Интерфейс на естественном языке

🔐 Безопасность и конфиденциальность

• ✅ Ключи API хранятся в .env (никогда не коммитятся)

• ✅ Все данные обрабатываются локально

• ✅ Нет внешнего логирования или аналитики

• ✅ Plaid обеспечивает шифрование банковского уровня

⚠️ Важно: Никогда не коммитьте ваш файл .env или ключи API на GitHub!

🤝 Участие в разработке

Вклад приветствуется! Не стесняйтесь:

• Сообщать об ошибках

• Предлагать функции

• Отправлять pull-запросы

📝 Лицензия

Лицензия MIT

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

• Создано с помощью MCP от Anthropic

• Работает на Plaid

⭐ Если вам это помогло, пожалуйста, поставьте звезду репозиторию!