Polygon-io MCP Server

[!ВАЖНЫЙ]
:test_tube: Этот проект является экспериментальным и может быть подвержен критическим изменениям.

Сервер MCP Polygon.io

Сервер протокола контекста модели (MCP) , который обеспечивает доступ к API данных финансового рынка Polygon.io через дружественный LLM интерфейс.

Обзор

Этот сервер представляет все конечные точки API Polygon.io как инструменты MCP, обеспечивая доступ к комплексным данным финансового рынка, включая:

• Агрегаты и бары акций, опционов, форекс и криптовалют
• Сделки и котировки в реальном времени и исторические данные
• Обзор рынка
• Реквизиты тикера и справочные данные
• Данные о дивидендах и дроблениях
• Финансовые основы
• Состояние рынка и праздники

Установка

Предпосылки

• Питон 3.10+
• API-ключ Polygon.io
• Астральный УФ
  • Для существующих установок проверьте, что у вас есть версия, поддерживающая команду uvx .

Клод Код

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

Используйте следующую команду для добавления сервера Polygon MCP в вашу локальную среду. Это предполагает, что uvx находится в вашем $PATH; если нет, то вам нужно указать полный путь к uvx .

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

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

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

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

Клод Десктоп

1. Следуйте инструкциям по установке Claude Desktop MCP, чтобы завершить первоначальную установку и найти файл конфигурации.
2. Используйте следующий пример в качестве справочного материала для добавления сервера MCP Polygon. Убедитесь, что вы заполнили различные поля.
   1. Path найдите путь к uvx , запустите which uvx в вашем терминале.
   2. Замените <your_api_key_here> на ваш фактический ключ API Polygon.io.
   3. Замените <your_home_directory> на путь к вашему домашнему каталогу, например, /home/username (Mac/Linux) или C:\Users\username (Windows).

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

После интеграции вы можете предоставить Клоду доступ к данным Polygon.io:

Доступные инструменты

Этот сервер MCP реализует все конечные точки API Polygon.io в качестве инструментов, включая:

• get_aggs - данные по биржевым агрегатам (OHLC) для определенного тикера
• list_trades - Исторические данные о торговле
• get_last_trade — Последняя сделка по символу
• list_ticker_news - Последние новостные статьи для тикеров
• get_snapshot_ticker — Текущий снимок рынка для тикера
• get_market_status - Текущее состояние рынка и часы торговли
• list_stock_financials - Фундаментальные финансовые данные
• И многое другое...

Каждый инструмент следует структуре параметров Polygon.io SDK, преобразуя ответы в стандартный JSON, который LLM могут легко обработать.

Разработка

Работает локально

Проверьте, установлены ли у вас необходимые компоненты .

Отладка

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

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

Ссылки

• Документация Polygon.io
• Модель контекстного протокола
• MCP Python SDK

Внося вклад

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