The Finance Toolkit MCP
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
- 5 520 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ходит в сеть за финансовыми данными по вашему ключу
- Расчеты справочные, инвестиционных решений не заменяют
Установка
- Работает в
Ручная установка
uvx --from "financetoolkit[mcp]" financetoolkit-mcp-setupЛокальный сервер: настраивает конфигурацию клиента и ключ автоматически.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ходит в сеть за финансовыми данными по вашему ключу
- Расчеты справочные, инвестиционных решений не заменяют
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент получает через MCP более 500 методов библиотеки Finance Toolkit, организованных по модулям: поиск инструментов и скринер акций, отчетность и коэффициенты, оценочные модели, опционы и греки, технические индикаторы, метрики доходности и просадки, экономические показатели, облигации, портфель и эконометрика. Каждый показатель считается из исходных отчетностей по формуле, которая написана в открытом коде, поэтому цифры можно сверить. Данные берутся у Financial Modeling Prep, а при отказе провайдера (ограничение тарифа, проблема с ключом) библиотека переключается на Yahoo Finance; флаг enforce_source отключает переключение. Многие функции принимают параметры rolling, trailing, growth и standardize, а результаты можно кэшировать в локальной SQLite и разделять кэш между библиотекой и MCP-сервером. Подключение возможно к размещенному серверу по OAuth либо к локальному серверу через uvx, есть и пакет .mcpb для Claude Desktop.
Для кого. Для финансовых и инвестиционных аналитиков, исследователей рынка и разработчиков, кому нужен расчет метрик по компаниям через агента.
Подходит, если
- Вы сравниваете Apple и Microsoft за пять лет и хотите получить рентабельность капитала, ликвидность и долговую нагрузку таблицей, не открывая Excel
- Нужно найти компании по условиям: полупроводники, США, биржа NASDAQ, капитализация выше 100 миллиардов долларов (модуль Discovery)
- Требуется оценить опцион или рассчитать греки по тикеру, не собирая формулы вручную
- Нужны ряды ставок казначейских облигаций и макроэкономических индикаторов для объяснения динамики актива
- Вы пишете аналитику на Python и хотите повторить расчет агента у себя через pip install financetoolkit и получить те же цифры
Не подходит, если
- Нужны акции и облигации Московской биржи: посмотрите MOEX MCP Server из каталога
- Нужны китайские материковые акции с отчетами брокеров и потоками денег: для них есть скилл a-stock-data
- Нужен готовый рейтинг акций или рекомендация: сервер считает показатели, оценку и решение принимаете вы
- Вы не готовы заводить ключ Financial Modeling Prep: без него данных не будет, бесплатный тариф ограничен 250 запросами в день и пятью годами истории
Пример запроса к агенту
Возьми тикеры AAPL, MSFT и NVDA, посчитай за последние пять лет коэффициент ROE, текущую ликвидность и отношение долга к капиталу, выведи таблицей по годам и покажи, как менялся ROE у каждой компанииMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
FINANCIAL_MODELING_PREP_API_KEYобязательная, секрет- Ключ Financial Modeling Prep для доступа к отчетностям и данным
Ограничения
Доступ: расширенный. Размещенный сервер принимает ваш ключ Financial Modeling Prep на странице согласия OAuth и делает запросы к провайдерам данных от вашего имени; локальный запускается через uvx, читает ключ из переменной FINANCIAL_MODELING_PREP_API_KEY и при включенном кэше пишет данные в локальную SQLite в каталоге настроек пользователя. Бесплатный тариф Financial Modeling Prep: 250 запросов в день, 5 лет данных, только компании на биржах США. Данные макроэкономики и курсов берутся из отдельных источников (FRED, OECD, Yahoo Finance). Сервер только вычисляет показатели и не заменяет консультацию. Для клиентов с Claude Desktop есть пакет .mcpb, для Claude Code одна команда добавления сервера по HTTP.
Как отключить. Удалите запись finance-toolkit из конфигурации MCP-клиента, для локального варианта удалите пакет financetoolkit.
Частые вопросы
Откуда берутся значения?
Методы считаются из исходных финансовых отчетностей, без готовых показателей чужих эндпоинтов, поэтому расчет прозрачен. Формулы лежат в коде библиотеки, а в документации к каждому модулю есть описание параметров.
Обязателен ли ключ?
Для полного доступа к данным нужен ключ Financial Modeling Prep. При исчерпании лимита часть запросов подстраховывается через Yahoo Finance, а параметр enforce_source позволяет закрепить один источник.
Как подключить сервер к Claude Code?
Выполните claude mcp add --transport http finance-toolkit https://financetoolkit.jeroenbouma.com/mcp, при первом запросе откроется страница OAuth, куда вводится ключ. Локальный вариант ставится командой uvx --from "financetoolkit[mcp]" financetoolkit-mcp-setup.
Как проверить, что подключение работает?
Попросите агента найти компании по простому условию или вывести историю цен одного тикера. Если ключ принят, придут данные, а при ошибке доступа сервер сообщит о проблеме с источником.
Чем это отличается от других финансовых MCP-серверов?
Alpha Vantage MCP Server и Financial Datasets MCP Server из каталога отдают данные провайдеров. Finance Toolkit считает показатели сам по открытым формулам из отчетностей, поэтому цифры можно воспроизвести в Python.
Почему сбор данных идет медленно?
В README сказано, что история по 100 тикерам обычно собирается быстрее 15 секунд. Если дольше, причина в лимите запросов тарифа, медленной сети или неоптимальном коде. Число потоков сбора настраивается переменной окружения, а повторные запросы ускоряет кэш.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыFinancial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
MCP-сервер для личного анализа акций: рыночные данные, технические индикаторы, скрининг и учет портфеля без ключей для базовых функций
MCP сервер финансовых данных: акции, фонды, облигации, макропоказатели, новости и крипта через Tushare и Binance
Рыночные данные в диалоге с агентом: размещенный сервер или локальный запуск, три режима и наборы инструментов по запросу
Неофициальный клиент Yahoo Finance с MCP-сервером, CLI и агентским скиллом: котировки, история цен, финансовые отчеты и опционы для агента
MCP-сервер отдает агенту данные Yahoo Finance по тикеру: историю цен, финансовую отчетность и цепочки опционов
Коротко о README
README представляет Finance Toolkit как прозрачный набор для финансового анализа с сотнями методов, доступный и как Python-пакет, и как MCP-сервер. Через MCP можно запрашивать более 500 методов из Claude, Copilot, Cursor, Windsurf и других клиентов без кода. Есть два пути: размещенный сервер с OAuth и локальный запуск через uvx с автоматической настройкой. Для данных нужен ключ Financial Modeling Prep, при лимите работает запас через Yahoo Finance, макроданные берутся из OECD и других источников. Сервер также опубликован в Smithery и Glama, лицензия MIT.