MCP-сервер Massive.com

Сервер Model Context Protocol (MCP), предоставляющий доступ к полному API финансовых данных Massive.com через интерфейс, удобный для LLM.

Вместо того чтобы предоставлять по одному инструменту на каждую конечную точку, этот сервер дает LLM три компонуемых инструмента — search (поиск), call (вызов) и query (запрос), — которые охватывают всю поверхность API Massive.com. Данные могут храниться в оперативной базе данных SQLite и дополняться встроенными финансовыми функциями.

Инструменты

Встроенные функции

Функции могут применяться к результатам API или выводу запросов через параметр apply в call_api и query_data. Используйте search_endpoints с scope="functions" для их поиска.

Покрытие данных

Сервер динамически индексирует все конечные точки API Massive.com при запуске из llms.txt, поэтому он автоматически остается синхронизированным с API. Покрытие включает:

• Агрегаты акций, опционов, форекс, криптовалют и фьючерсов

• Торги и котировки в реальном времени и исторические данные

• Рыночные снимки, лидеры роста/падения

• Данные о тикерах и справочную информацию

• Дивиденды, сплиты, IPO

• Финансовые фундаментальные показатели

• Рейтинги аналитиков и новости (Benzinga)

• Доходность казначейских облигаций, данные об инфляции

• Статус рынка и праздничные дни

Related MCP server: Dingo MCP Server

Установка

Предварительные требования

• Python 3.12+

• API-ключ Massive.com

• Astral UV (v0.4.0+)

Claude Code

Сначала установите Claude Code

npm install -g @anthropic-ai/claude-code

Установите MCP-сервер, а затем зарегистрируйте его в Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Для обновления до новой версии в будущем:

uv tool upgrade mcp_massive

Эта команда установит MCP-сервер в ваш текущий проект. Если вы хотите установить его глобально, вы можете запустить команду с флагом -s <scope>. Смотрите claude mcp add --help для получения дополнительных опций.

Чтобы запустить Claude Code, введите claude в терминале.

• Если вы используете его впервые, следуйте подсказкам настройки для аутентификации

Вы также можете запустить claude mcp add-from-claude-desktop, если MCP-сервер уже установлен для Claude Desktop.

Claude Desktop

1. Следуйте инструкциям по установке Claude Desktop MCP, чтобы завершить начальную установку и найти файл конфигурации.

2. Установите сервер:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

3. Найдите путь к установленному бинарному файлу:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Добавьте сервер в конфигурацию Claude Desktop. Замените <path_to_mcp_massive> на вывод предыдущего шага и заполните оставшиеся поля.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

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

Переменные окружения

Транспорт

По умолчанию используется транспорт STDIO. Транспорт можно задать через аргумент CLI --transport или переменную окружения MCP_TRANSPORT (аргумент CLI имеет приоритет).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Примеры использования

После интеграции вы можете попросить Claude получить доступ к данным Massive.com:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

Разработка

Локальный запуск

Убедитесь, что у вас установлены Предварительные требования.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

Установите из локальной копии, затем ссылайтесь на бинарный файл напрямую:

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Отладка

Для отладки и тестирования мы рекомендуем использовать MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Это запустит интерфейс браузера, где вы сможете напрямую взаимодействовать с вашим MCP-сервером и видеть ввод/вывод для каждого инструмента.

Выберите тип транспорта STDIO в пользовательском интерфейсе браузера с командой uv и run mcp_massive в качестве аргументов.

Линтинг кода

Этот проект использует just для общих задач разработки. Чтобы выполнить линтинг кода перед отправкой PR:

just lint

Это запустит ruff format и ruff check --fix для автоматического форматирования кода и исправления проблем линтинга.

Ссылки

• Документация Massive.com

• Model Context Protocol

• Python SDK для MCP

Политика конфиденциальности

Этот MCP-сервер взаимодействует с API Massive.com для получения рыночных данных. Все запросы данных регулируются политикой конфиденциальности и условиями обслуживания Massive.com.

• Политика конфиденциальности Massive.com: https://massive.com/legal/privacy

• Обработка данных: Этот сервер не хранит и не кэширует пользовательские данные. Все запросы проксируются напрямую к API Massive.com.

• API-ключ: Ваш API-ключ Massive.com используется только для аутентификации запросов к их API.

• User-Agent: API-запросы включают строку User-Agent, содержащую версию MCP-сервера (например, MCP-Massive/0.x.y). Никакая личная информация не включается.

Участие в разработке

Если вы нашли ошибку или у вас есть идея для новой функции, пожалуйста, сначала обсудите ее с нами, создав новый issue. Мы ответим на вопросы максимум в течение 3 недель. Мы также открыты для волонтеров, если вы хотите отправить PR для любых открытых задач, но, пожалуйста, обсудите это с нами заранее. PR, которые не связаны с существующим issue или не обсуждались с нами заранее, как правило, будут отклонены.