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

Сервер MCP Polygon.io

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

Обзор

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

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

Related MCP server: Dingo MCP Server

Установка

Предпосылки

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

Клод Код

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

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

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

# Claude CLI
claude mcp add polygon -e POLYGON_API_KEY=your_api_key_here -- uvx --from git+https://github.com/polygon-io/mcp_polygon@v0.1.0 mcp_polygon

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

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

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

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

Клод Десктоп

Следуйте инструкциям по установке Claude Desktop MCP, чтобы завершить первоначальную установку и найти файл конфигурации.
Используйте следующий пример в качестве справочного материала для добавления сервера 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).

{
    "mcpServers": {
        "polygon": {
            "command": "<path_to_your_uvx_install>/uvx",
            "args": [
                "--from",
                "git+https://github.com/polygon-io/mcp_polygon@v0.1.0",
                "mcp_polygon"
            ],
            "env": {
                "POLYGON_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

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

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

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

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

Этот сервер 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 могут легко обработать.

Разработка

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

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

# Sync dependencies
uv sync

# Run the server
POLYGON_API_KEY=your_api_key_here uv run mcp_polygon


  "mcpServers": {
    "polygon": {
      "command": "/your/path/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "/your/path/mcp_polygon",
        "mcp_polygon"
      ],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here",
        "HOME": "/Users/danny"
      }
    }
  }

Отладка

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

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

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

Ссылки

Внося вклад

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

Polygon-io MCP Server