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

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "equivault": {
      "command": "npx",
      "args": ["-y", "equivault-mcp"],
      "env": {
        "EQUIVAULT_API_KEY": "your-api-key",
        "EQUIVAULT_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Claude Code

claude mcp add equivault -- npx -y equivault-mcp

Затем установите свои учетные данные:

export EQUIVAULT_API_KEY=your-api-key
export EQUIVAULT_TENANT_ID=your-tenant-id

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

Переменная	Обязательно	По умолчанию	Описание
`EQUIVAULT_API_KEY`	Да	—	Ваш API-ключ EquiVault
`EQUIVAULT_TENANT_ID`	Да	—	Ваш ID арендатора EquiVault
`EQUIVAULT_BASE_URL`	Нет	`https://api.equivault.ai/api/v1`	Базовый URL API (переопределите для self-hosted)

Инструменты

Основные исследования (M1)

Инструмент	Описание
`search_companies`	Поиск компаний по названию, тикеру или ключевому слову
`get_company`	Получение подробного профиля компании
`get_financials`	Финансовая отчетность (отчет о прибылях и убытках, баланс, отчет о движении денежных средств)
`get_metrics`	Временные ряды финансовых коэффициентов и метрик
`get_stock_quote`	Текущая цена акций, изменение и объем торгов
`screen_companies`	Фильтрация компаний по финансовым критериям
`compare_companies`	Сравнение компаний с конкурентами
`get_billing_status`	Проверка уровня подписки и использования API

Глубокие данные о компаниях (M2)

Инструмент	Описание	Уровень
`get_company_narrative`	Инвестиционный тезис, драйверы, риски и возможности	Starter+
`get_guidance`	Трекер прогнозов руководства с результатами (превзошли/не достигли)	Professional+
`get_segments`	Выручка и операционная прибыль по бизнес-сегментам	Professional+
`get_capital_allocation`	История обратного выкупа, дивидендов, долга, M&A и капитальных затрат	Professional+
`get_risk_factors`	Эволюция факторов риска на основе отчетности	Professional+
`get_insider_transactions`	Инсайдерские покупки, продажи, флаг 10b5-1	Advisor+
`get_earnings_quality`	Начисления, конверсия денежных средств, флаги не по GAAP	Professional+
`get_debt_maturities`	График погашения долга	Professional+
`get_competitive_signals`	Доля рынка, новые участники, ценовые сигналы	Professional+
`get_management_statements`	Значимые заявления руководства с анализом тональности	Advisor+
`get_accounting_snapshots`	Учетная политика и изменения между периодами	Professional+
`get_strategy_profiles`	Доступные профили инвестиционных стратегий	Все

Композитные инструменты (M2)

Инструмент	Описание
`analyze_company`	Однократный запрос: профиль + финансы + метрики + нарратив
`company_deep_dive`	Все из `analyze_company` + все 10 разделов профиля

Сигналы и оповещения (M3)

Инструмент	Описание	Уровень
`get_signals`	Пагинированные сигналы для одной компании	Analyst+
`get_signal_summary`	Разбивка по типу/серьезности + количество непрочитанных	Analyst+
`get_signal_dashboard`	Обзор сигналов по всему портфелю	Analyst+
`get_signal_trends`	Активность по временным интервалам в портфеле	Analyst+
`get_trending_signals`	Актуальные трендовые сигналы по всем компаниям	Analyst+
`create_alert`	Создание правила оповещения	Advisor+
`update_alert`	Обновление правила оповещения	Advisor+
`delete_alert`	Удаление правила оповещения	Advisor+

Сводки, портфель и медиа (M3)

Инструмент	Описание	Уровень
`list_briefs`	Список инвестиционных сводок (фильтр по компании или отслеживаемым)	Starter+
`get_brief`	Полное содержание сводки с оценочной картой	Starter+
`get_portfolio_analytics`	Доходность, коэффициент Шарпа, отраслевое распределение, лидеры/аутсайдеры	Analyst+
`list_media`	Отчеты о прибылях, подкасты, презентации, пресс-релизы	Starter+
`get_guru_holdings`	Портфели известных инвесторов и их изменения	Analyst+
`get_markets`	Доступные рынки (код, страна, валюта, MIC)	Все

Продвинутые композитные инструменты (M3)

Инструмент	Описание
`morning_briefing`	Дашборд сигналов + тренды + сводки + опциональный портфель — в одном запросе
`research_report`	`company_deep_dive` + последние сигналы + связанные сводки, готовые к выводу

Примеры

Исследование компании:

"Каковы последние годовые финансовые показатели и ключевые метрики Apple?"

Поиск возможностей:

"Найди технологические компании с рыночной капитализацией более $10 млрд и коэффициентом P/E менее 20."

Сравнение конкурентов:

"Сравни Microsoft, Google и Amazon по росту выручки и рентабельности прибыли."

Проверка статуса аккаунта:

"Сколько запросов у меня осталось в этом месяце?"

Документация

EXAMPLES.md — Реальные промпты для Claude для каждой категории инструментов
docs/ALIGNMENT.md — Как MCP синхронизируется с версиями API платформы
CHANGELOG.md — Примечания к выпуску для каждой версии
CONTRIBUTING.md — Рабочий процесс разработки и соглашения

Разработка

# Clone and install
git clone https://github.com/equivault/equivault-mcp
cd equivault-mcp
npm install

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

# Watch mode (development)
npm run dev

Лицензия

MIT

equivault-mcp