Hub-Equity MCP — MCP-сервер для Claude Code: обзор и запуск
Поставляет нормализованную финансовую отчётность SEC и ESEF в контекст агента. Позволяет сравнивать показатели компаний по единому справочнику кодов.
claude mcp add hub-equity-mcp -e HUBEQUITY_API_KEY=<HUBEQUITY_API_KEY> -- uvx hub-equity-mcpЧто делает Hub-Equity MCP
Сервер подключает языковую модель к публичному REST API Hub-Equity и нормализует XBRL-показатели из американской базы EDGAR и европейского стандарта ESEF. Модель запрашивает унифицированные коды, например REVENUE или TOTAL_ASSETS, сопоставляя стандарты US-GAAP и IFRS. Каждое число снабжено ссылкой на конкретную форму и отчётный период.
В набор входят инструменты поиска эмитентов find_entity, извлечения фактов get_fact, построения исторических рядов get_metric_history, а также трекеры прямых исправлений get_amendments и неявных корректировок get_silent_restatements. Все методы работают только на чтение. Базовый уровень доступен по бесплатному ключу, а расширенное сравнение компаний требует платного тарифа.
Для работы сервера строго требуется Python 3.12 или новее. Без переменной окружения HUBEQUITY_API_KEY вызовы инструментов будут возвращать ошибку авторизации.
Какие задачи решает
- сопоставить финансовые показатели американских и европейских эмитентов
- проверить историю неявных пересчётов отчётности без явных правок 10-K/A
- выгрузить временные ряды метрик компании с динамикой год к году
- найти идентификатор компании по тикеру, названию или CIK
Примеры запросов агенту
- Найди выручку и совокупные активы Apple за 2023 год через Hub-Equity
- Проверь, были ли у эмитента неявные корректировки отчётности за последние три года
- Сравни динамику показателей выручки двух компаний по тикерам
Как установить Hub-Equity MCP
Командой платформы
claude mcp add hub-equity-mcp -e HUBEQUITY_API_KEY=<HUBEQUITY_API_KEY> -- uvx hub-equity-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hub-equity-mcp <команда>
Командой платформы
codex mcp add hub-equity-mcp --env HUBEQUITY_API_KEY=<HUBEQUITY_API_KEY> -- uvx hub-equity-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hub-equity-mcp <команда>
Файл настроек
{
"mcpServers": {
"hub-equity-mcp": {
"command": "uvx",
"args": [
"hub-equity-mcp"
],
"env": {
"HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hub-equity-mcp <команда>
Файл настроек
{
"servers": {
"hub-equity-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"hub-equity-mcp"
],
"env": {
"HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hub-equity-mcp <команда>
Командой платформы
gemini mcp add -e HUBEQUITY_API_KEY=<HUBEQUITY_API_KEY> hub-equity-mcp uvx hub-equity-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hub-equity-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hub-Equity MCP
Как установить Hub-Equity MCP в Claude Code?
Выполните в терминале команду claude mcp add hub-equity-mcp -e HUBEQUITY_API_KEY=<HUBEQUITY_API_KEY> -- uvx hub-equity-mcp, указав свой ключ доступа.
Что делает Hub-Equity MCP?
Сервер нормализует финансовые отчёты SEC и ESEF, приводя концепции US-GAAP и IFRS к единым кодам для анализа в агенте.
Что требуется для запуска сервера?
Необходим интерпретатор Python 3.12 или новее и ключ в переменной HUBEQUITY_API_KEY, созданный в настройках Hub-Equity.