MCP-сервер для Copilot Money

Запрашивайте и управляйте своими личными финансами с помощью ИИ, используя локальные данные Copilot Money

Отказ от ответственности

Это независимый проект, созданный сообществом, который никак не связан с Copilot Money или ее материнской компанией, не поддерживается и не одобрен ими. Этот инструмент был создан независимым разработчиком для обеспечения возможности ИИ-запросов к локально кэшированным данным. «Copilot Money» является торговой маркой соответствующего владельца.

Обзор

MCP-сервер, который предоставляет ИИ-ассистентам доступ к вашим данным о личных финансах в Copilot Money. Он считывает данные из локально кэшированной базы данных Firestore (LevelDB + Protocol Buffers) на вашем Mac. Чтение происходит на 100% локально без сетевых запросов. Опциональный режим записи (включается через --write) отправляет запрошенные вами изменения напрямую в бэкенд Firebase/Firestore приложения Copilot Money — тот же бэкенд, который использует само приложение Copilot Money — с аутентификацией через ваши собственные учетные данные, минуя любые сторонние сервисы.

35 инструментов для работы с расходами, инвестициями, бюджетами, целями и многим другим:

• 17 инструментов чтения — запрос транзакций, счетов, активов, балансов, категорий, регулярных платежей, бюджетов, целей, эффективности инвестиций и многого другого

• 18 инструментов записи (опционально) — консолидация изменений транзакций, управление тегами, создание бюджетов, обновление регулярных платежей и организация ваших финансов

По умолчанию доступен только для чтения. Инструменты записи требуют явного запуска сервера с флагом --write для активации.

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

Мы никогда не собираем, не храним и не передаем ваши данные на какой-либо сервер, управляемый этим проектом — у нас их просто нет. Подробности см. в нашей Политике конфиденциальности.

• Никакой аналитики, телеметрии или отслеживания любого рода

• Чтение полностью локальное — ноль сетевых запросов

• По умолчанию только чтение (инструменты записи отключены, если вы не используете --write)

• В режиме записи запросы идут напрямую с вашего компьютера в бэкенд Firebase/Firestore приложения Copilot Money с использованием ваших собственных учетных данных — никогда через сторонние сервисы

• Открытый исходный код — проверяйте код самостоятельно

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

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

• Node.js 18+ (поставляется в комплекте с Claude Desktop)

• Copilot Money (версия из macOS App Store)

• Claude Desktop, Cursor или любой другой MCP-совместимый клиент

Установка через Claude Desktop

1. Загрузите последний пакет .mcpb из раздела Releases

2. Дважды щелкните файл .mcpb для установки в Claude Desktop

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

4. Начните задавать вопросы о своих финансах!

Установка через npm

npm install -g copilot-money-mcp

Затем добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Установка для Cursor

1. Установите пакет глобально:

npm install -g copilot-money-mcp

2. Откройте настройки Cursor (Cmd + ,) > Features > MCP Servers

3. Добавьте конфигурацию сервера:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Что вы можете делать

Анализ расходов

«Сколько я потратил на рестораны в прошлом месяце?»

«Покажи мне все мои покупки на Amazon за последние 30 дней»

«Какие 5 категорий расходов у меня самые крупные в этом году?»

Использует get_transactions, get_categories с диапазонами дат, текстовым поиском и фильтрами категорий.

Обзор счетов

«Каков мой чистый капитал по всем счетам?»

«Покажи мне баланс моего расчетного счета за последние 6 месяцев по месяцам»

«Какие банковские подключения требуют внимания?»

Использует get_accounts, get_balance_history, get_connection_status.

Инвестиционный портфель

«Какие у меня текущие активы и общая доходность?»

«Покажи мне историю цен AAPL за последний год»

«Какова моя доходность с учетом времени (TWR) за этот квартал?»

Использует get_holdings, get_investment_prices, get_securities, get_investment_performance, get_twr_returns.

Бюджеты и цели

«Укладываюсь ли я в свои бюджеты в этом месяце?»

«Как продвигается мой резервный фонд?»

«Покажи мне историю моих целей за последние 6 месяцев»

Использует get_budgets, get_goals, get_goal_history.

Подписки и регулярные платежи

«За какие подписки я плачу?»

«Сколько я трачу на регулярные платежи в месяц?»

Использует get_recurring_transactions.

Организация финансов (режим записи)

«Классифицируй все мои транзакции Uber как транспорт»

«Отметь мои расходы на отпуск тегом #vacation»

«Создай ежемесячный бюджет на питание в размере $500»

«Настрой Netflix как ежемесячный регулярный платеж»

Использует инструменты записи, такие как update_transaction, create_budget, update_recurring и другие. Требуется флаг --write.

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

Инструменты чтения (17)

Инструменты записи (18) — требуется флаг --write

Режим записи

По умолчанию сервер запускается в режиме только для чтения. Чтобы включить инструменты записи, запустите сервер с флагом --write:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp",
      "args": ["--write"]
    }
  }
}

Инструменты записи изменяют ваши данные Copilot Money, отправляя аутентифицированные запросы напрямую в бэкенд Firebase/Firestore приложения Copilot Money — тот же бэкенд, который использует приложение Copilot Money, — поэтому ваши изменения немедленно отражаются в вашей учетной записи. Запись аутентифицируется с использованием токена обновления Firebase, извлеченного из вашей локальной сессии Copilot Money; ваши учетные данные никогда не покидают ваш компьютер, за исключением аутентифицированного запроса к конечным точкам Google Firebase/Firestore. Сторонние сервисы не участвуют. Полную информацию см. в PRIVACY.md.

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

TTL кэша

Сервер кэширует данные в памяти на 5 минут. Настраивается через переменную окружения:

# Set cache TTL to 10 minutes
COPILOT_CACHE_TTL_MINUTES=10 copilot-money-mcp

# Disable caching (always reload from disk)
COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp

Вы также можете обновить данные вручную с помощью инструмента refresh_database.

Тайм-аут декодирования

Для больших баз данных (500 МБ+) увеличьте тайм-аут декодирования (по умолчанию: 90 секунд):

# Via environment variable
DECODE_TIMEOUT_MS=600000 copilot-money-mcp

# Via CLI flag
copilot-money-mcp --timeout 600000

Для баз данных объемом более 1 ГБ также увеличьте память Node.js:

{
  "mcpServers": {
    "copilot-money": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096",
        "/path/to/copilot-money-mcp/dist/cli.js",
        "--timeout", "600000"
      ]
    }
  }
}

Поддерживаемые периоды дат

Параметр period поддерживает следующие сокращения:

this_month last_month last_7_days last_30_days last_90_days ytd this_year last_year

Известные ограничения

Зависимость от локального кэша

Этот сервер считывает данные из локального кэша Firestore приложения Copilot Money, а не из облака. Автономное хранилище Firestore кэширует каждый документ, который когда-либо загружало приложение, поэтому локальная база данных обычно содержит все транзакции, счета, бюджеты, цели и другие данные, которые вы просматривали в приложении. Размер кэша Firestore по умолчанию составляет 100 МБ (достаточно для десятков тысяч транзакций), а старые документы удаляются только через сборщик мусора LRU, если этот лимит превышен.

Чтобы максимизировать объем кэшированных данных: Откройте приложение Copilot Money и просмотрите свои данные (историю транзакций, счета, бюджеты), чтобы убедиться, что они были загружены и кэшированы локально.

Устранение неполадок

База данных не найдена

Если вы видите «Database not available»:

1. Убедитесь, что Copilot Money установлена и данные синхронизированы

2. Проверьте расположение базы данных: ~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/__FIRAPP_DEFAULT/copilot-production-22904/main

3. Убедитесь, что файлы .ldb существуют в каталоге

4. Укажите пользовательский путь: copilot-money-mcp --db-path /path/to/database

Тайм-аут рабочего процесса декодирования

Если вы видите «Decode worker timed out»:

1. Увеличьте тайм-аут: copilot-money-mcp --timeout 300000 (5 минут)

2. Для баз данных 1 ГБ+ также увеличьте память Node.js: node --max-old-space-size=4096 dist/cli.js --timeout 300000

Транзакции не найдены

• Откройте приложение Copilot Money и дождитесь синхронизации

• Структура базы данных могла измениться — откройте issue

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

См. CONTRIBUTING.md для настройки среды разработки, архитектуры и информации о том, как добавлять новые инструменты.

Лицензия

Лицензия MIT — подробности см. в LICENSE.

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

• Создано с использованием MCP SDK от Anthropic

• Валидация данных с помощью Zod

• Разработано с использованием Bun