finary-mcp

Преднамеренно только для чтения сервер Model Context Protocol для Finary, построенный поверх неофициального клиента finary-uapi.

[!WARNING] Этот проект не зависит от Finary и не одобрен, не поддерживается и не сопровождается Finary. Он использует частные недокументированные конечные точки через finary-uapi; любой из проектов может сломаться без предупреждения. Это не финансовый, налоговый, юридический или инвестиционный совет.

Модель безопасности

finary-mcp — это намеренно узкий адаптер только для чтения:

• Он предоставляет только запросы профиля, организации, учреждения, портфеля и транзакций.

• У него нет инструментов входа, импорта счетов, создания, обновления, удаления, перевода, торговли или универсального CLI.

• Он формирует команды finary-uapi из фиксированного разрешённого списка без использования оболочки.

• Значения фильтров проверяются перед выполнением.

• Он не возвращает stdout/stderr вышестоящего процесса при сбое запроса, потому что процесс входа вышестоящего сервиса может выводить материал сеанса.

• Его каталог состояния задаётся явно (FINARY_MCP_STATE_DIR); сервер не ищет токены в произвольных рабочих каталогах.

Это снижает риск случайных записей через MCP. Это не делает машину безопасной, если другой процесс может читать ваши файлы сеанса. Запускайте сервер только для учётной записи и профиля, которым вы доверяете.

Важное замечание об аутентификации

«Только для чтения» относится к данным портфеля Finary. finary-uapi обновляет свой сеанс Clerk перед запросами и может перезаписывать jwt.json; поэтому частный каталог состояния должен оставаться доступным для записи локальной служебной учётной записью, даже если ни один инструмент MCP не изменяет данные Finary. Сервер никогда не возвращает этот файл, куки или диагностику дочерних процессов.

finary-uapi также привносит fuzzywuzzy как транзитивную зависимость GPL-2.0. Изучите граф зависимостей вышестоящего проекта и лицензионные последствия для предполагаемого распространения или развёртывания.

Related MCP server: C6 Bank MCP

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

• Python 3.10+.

• Локальный сеанс Finary, уже созданный finary-uapi.

• Частный каталог, содержащий jwt.json и localCookiesMozilla.txt, с режимом 0700 для каталога и 0600 для файлов.

Сервер сам не поддерживает Google OAuth. Следуйте процессу аутентификации, поддерживаемому finary-uapi, чтобы создать или обновить локальный сеанс. Никогда не отправляйте пароль, код TOTP, JWT, экспорт куки или файл сеанса агенту, репозиторию, трекеру задач или чату.

Установка

python -m venv .venv
. .venv/bin/activate
pip install finary-mcp

Для разработки из клонированного репозитория:

pip install -e '.[dev]'
pytest -q

Настройка MCP-хоста

Установите FINARY_MCP_STATE_DIR в каталог, содержащий ваш сеанс Finary. Если finary-uapi установлен в отдельном виртуальном окружении, установите FINARY_UAPI_PYTHON на исполняемый файл Python этого окружения.

Пример общей конфигурации stdio:

{
  "mcpServers": {
    "finary": {
      "command": "/path/to/finary-mcp/.venv/bin/finary-mcp",
      "env": {
        "FINARY_MCP_STATE_DIR": "/private/path/to/finary-state",
        "FINARY_UAPI_PYTHON": "/path/to/finary-uapi/.venv/bin/python"
      }
    }
  }
}

Используйте абсолютные пути. Каталог состояния — это приватные данные, которые никогда нельзя коммитить. Прилагаемый .gitignore исключает известные файлы сеанса.

Пример для Hermes Agent

mcp_servers:
  finary:
    command: /path/to/finary-mcp/.venv/bin/finary-mcp
    env:
      FINARY_MCP_STATE_DIR: /private/path/to/finary-state
      FINARY_UAPI_PYTHON: /path/to/finary-uapi/.venv/bin/python
    tools:
      include:
        - finary_me
        - finary_organizations
        - finary_institution_connections
        - finary_portfolio
        - finary_transactions

Добавляйте это через рабочий процесс MCP/конфигурации Hermes, а не копируйте учётные данные в публичный конфигурационный файл. Перезапустите процесс Hermes после добавления сервера, чтобы обнаружение инструментов запустилось заново.

Инструменты

Зависимость: finary-uapi

Этот проект — адаптер, а не повторная реализация API Finary. Он вызывает CLI finary-uapi из проекта lasconic/finary_uapi, чей пакет в настоящее время объявлен в pyproject.toml как finary-uapi>=0.2.3,<0.3.

Эта зависимость использует недокументированные конечные точки Finary и сохраняет локальный сеанс. Изучите её исходный код и лицензию перед использованием этого сервера. Когда потребуется обновление вышестоящего проекта, сначала протестируйте его в отдельном окружении и зафиксируйте здесь совместимую версию.

Разработка

pytest -q
python -m build

Тесты не используют реальную учётную запись Finary и не должны создавать файлы сеанса. Перед публикацией проверьте подготовленные файлы на наличие jwt.json, localCookiesMozilla.txt, учётных данных, адресов электронной почты, куки и токенов.

Лицензия

MIT. См. LICENSE.