massive-mcp

MCP-сервер (Model Context Protocol), который предоставляет доступ к REST API акций Massive.com для Claude Desktop и Claude Code.

Создан с использованием FastMCP + httpx (асинхронно). Транспорт Stdio.

Что поддерживается

Настройки по умолчанию оптимизированы для получения небольших ответов (низкий limit, усечение до 200 элементов с примечанием _truncated_note). Все инструменты с поддержкой пагинации принимают cursor и возвращают next_cursor, если доступны дополнительные данные.

Установка

# Recommended: uv
uv tool install --from . massive-mcp
# or pipx
pipx install .

Для разработки:

uv sync --extra dev
uv run pytest

Настройка

Установите свой API-ключ через переменные окружения. Поддерживаются оба режима аутентификации — начните с bearer; если Massive возвращает ошибку 401, переключитесь на query.

export MASSIVE_API_KEY=sk_live_...
export MASSIVE_AUTH_MODE=bearer   # or "query"

Или скопируйте .env.example в .env.

Подключение

Claude Desktop

Отредактируйте claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": ["massive-mcp"],
      "env": {
        "MASSIVE_API_KEY": "sk_live_...",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

Перезапустите Claude Desktop.

Claude Code

claude mcp add massive --env MASSIVE_API_KEY=sk_live_... --env MASSIVE_AUTH_MODE=bearer -- uvx massive-mcp

Локальная разработка

uv run massive-mcp

Используйте MCP Inspector для ручного тестирования инструментов:

npx @modelcontextprotocol/inspector uvx massive-mcp

Попробуйте

После подключения задавайте Claude вопросы, например:

• "Какова была цена закрытия NVDA?"

• "Получи дивиденды AAPL за последние 12 месяцев."

• "Покажи 10 лидеров роста прямо сейчас."

• "Получи 5-минутные бары для TSLA за вчерашний день."

• "RSI для SPY за последние 30 дней."

Дополнительный навык

Этот репозиторий также содержит навык для Claude — massive-trade-analysis — который использует инструменты MCP для создания профессиональных планов для свинг-трейдинга или долгосрочной торговли (вход, стоп-лосс, каскадные тейк-профиты, соотношение риск/прибыль, расчет размера позиции). Инструкции по установке см. в skills/.

Примечания и ограничения

• Только REST. Поддержка WebSocket / FlatFiles отсутствует.

• Только класс активов «Акции». Эндпоинты для опционов/валют/криптовалют не входят в область действия v1.

• Некоторые эндпоинты (/vX/...) имеют статус бета-версии в Massive — пути могут измениться.

• Ответы 429 автоматически повторяются с учетом заголовка Retry-After. Ошибки 5xx повторяются с экспоненциальной задержкой (максимум 3 попытки).

• API-ключ никогда не записывается в логи. Ошибки удаляют apiKey из отображаемого URL.

Лицензия

MIT