Wealthfolio MCP
Учет инвестиций и расходов с встроенным MCP-сервером: агент читает портфель, а записи делает через черновики
- 9 336 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Агент читает счета, позиции, чистый капитал и расходы, то есть личные финансовые данные попадают в контекст модели
- Области `activities:write` и `spending:write` дают агенту право сохранять и удалять операции, поэтому начинать лучше с набора `read-only`
Установка
- Работает в
Ручная установка
claude mcp add --scope user --transport http wealthfolio <адрес> --header "Authorization: Bearer <токен>"Адрес сервера и токен берут в настройках AI Agent Access приложения.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает счета, позиции, чистый капитал и расходы, то есть личные финансовые данные попадают в контекст модели
- Области `activities:write` и `spending:write` дают агенту право сохранять и удалять операции, поэтому начинать лучше с набора `read-only`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Wealthfolio — приватный менеджер инвестиций, чистого капитала и расходов со встроенным MCP-сервером. В настройках он называется AI Agent Access и работает в настольном приложении на Tauri и в веб-сервере на Docker по адресу `/mcp`. Мобильная версия MCP не поддерживает. Агент читает счета, остатки, позиции, структуру активов, динамику стоимости, доход, чистый капитал, результативность, цели и расходы. Записывает он через черновики: `record_activity` готовит операцию, а `commit_activity_draft` сохраняет ее, и для этого нужна отдельная область доступа. Доступ выдается токеном (Personal Access Token) с выбранными областями, готовые наборы идут от `read-only` до записи операций. Каждый вызов проверяется по области токена, а запросы агентов по умолчанию попадают в журнал аудита.
Для кого. Частным инвесторам, которые ведут портфель в Wealthfolio и хотят разбирать его и свои расходы вместе с Claude Code, Cursor или Codex.
Подходит, если
- Агент сводит доходность по счетам и сравнивает ее с целью накопления
- Расходы месяца надо разнести по категориям, и агент подбирает их через `propose_transaction_categories`
- Брокерский CSV загружается в приложение: агент готовит импорт через `prepare_activity_import`, а вы подтверждаете
- Вопрос о валютах и классах активов получает ответ по данным `get_asset_allocation`
Не подходит, если
- Доступ нужен с телефона: мобильная версия локальный MCP не запускает
- Агенту хочется дать SQL-доступ к базе: произвольные запросы и прямое чтение SQLite в MCP не предусмотрены
- Требуются ордера у брокера: сервер ведет учет операций и не отправляет заявки на биржу
Пример запроса к агенту
Покажи, как распределены активы по валютам и какой доход принесли счета за последний годMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
WF_MCP_ENABLEDобязательная- Включает эндпоинт `/mcp` на веб-сервере, по умолчанию `false`
WF_MCP_AUDIT_ENABLED- Запись вызовов в журнал аудита, по умолчанию `true`
WF_MCP_ALLOWED_HOSTS- Допустимые значения заголовка Host через запятую
WEALTHFOLIO_TOKENобязательная, секрет- Personal Access Token клиента, создается в AI Agent Access
Ограничения
- Сервер работает только внутри запущенного приложения или веб-сервера, отдельного бинарника и stdio-режима нет.
- Клиент должен уметь Streamable HTTP, клиентам только со stdio сервер недоступен.
- На веб-сервере эндпоинт `/mcp` выключен, пока не задано `WF_MCP_ENABLED=true`.
- Токен показывают один раз, ротации нет: старый удаляют и создают новый. Запись зависит от черновиков: `activities:write` не работает без `activities:draft`.
Как отключить. Токены удаляют в настройках AI Agent Access, после этого клиенты теряют доступ. На веб-сервере эндпоинт закрывает `WF_MCP_ENABLED=false`, а из Claude Code сервер убирает `claude mcp remove wealthfolio`.
Частые вопросы
Как подключить Wealthfolio к Claude Code?
Создайте токен в настройках AI Agent Access и выполните `claude mcp add --scope user --transport http wealthfolio <адрес> --header "Authorization: Bearer <токен>"`. Адрес сервера и готовые фрагменты для других клиентов показывает тот же раздел настроек.
Может ли агент менять данные портфеля?
Только при выданных правах. `activities:draft` разрешает готовить черновики, а `activities:write` дает право сохранять и удалять операции. Набор `read-only` записи не включает.
Какие данные видит агент с набором `read-only`?
Счета и остатки, позиции, структуру активов, динамику стоимости, доход, чистый капитал, результативность, цели и расходы. Секреты, резервные копии и произвольные файлы инструменты не открывают.
Что попадает в журнал аудита?
Вызовы инструментов агентов. Вместо самого токена в записи остается его отпечаток. Запись отключает `WF_MCP_AUDIT_ENABLED=false`.
Как включить MCP на Docker-версии?
Задайте `WF_MCP_ENABLED=true` и запустите образ `wealthfolio/wealthfolio:latest`. Токен обязателен, а `WF_MCP_ALLOWED_HOSTS` дополнительно ограничивает значения заголовка Host.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыinvestor-agent отдает агенту котировки, историю цен, опционы, календарь отчетов и индекс страха и жадности без ключа.
MCP-аналитик портфеля Т-Инвестиций
tinkoff-wealth-mcp
Личный read-only MCP-сервер для портфеля Т-Инвестиций: сводный капитал, риск концентрации, календарь купонов, прогресс к финансовой цели
Неофициальный локальный MCP-сервер Т-Инвестиций: анализ портфеля, подбор бумаг и план ребалансировки, заявки только после подтверждения
MCP для Т-Инвестиций, только чтение
T-Bank Invest MCP Server (read-only)
MCP-сервер для портфеля Т-Инвестиций без прав на сделки: позиции, операции, рыночные данные, техническая и фундаментальная аналитика
MCP для Т-Инвестиций на C#
TInvestMcp
Консольный MCP-сервер на C# для Т-Инвестиций: счета, портфель, дивиденды, операции и брокерские отчеты, только чтение
MCP-сервер для личного анализа акций: рыночные данные, технические индикаторы, скрининг и учет портфеля без ключей для базовых функций
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Wealthfolio (эта карточка) | да | API-ключ | 9 336 | |
| MCP-аналитик портфеля Т-Инвестиций | нет | API-ключ | 1 | сервер только для чтения для одного портфеля Т-Инвестиций, без учета расходов и записи операций |
| Yahoo Finance MCP Server | нет | не нужна | 368 | отдает рыночные данные Yahoo Finance, личного портфеля у него нет |
Коротко о README
README представляет Wealthfolio как локальный трекер инвестиций с планированием, ребалансировкой, расходами и ИИ-ассистентом, к которому подключают внешних агентов через MCP. Для веб-сервера он описывает переменные `WF_MCP_ENABLED`, `WF_MCP_AUDIT_ENABLED` и `WF_MCP_ALLOWED_HOSTS`. Подробная схема областей доступа вынесена в документ проекта о доступе агентов.