StockFlow MCP Server

Сервер Model Context Protocol (MCP), предоставляющий данные о акциях в реальном времени и анализ опционов через Yahoo Finance. Позволяет LLM получать доступ к рыночным данным, анализировать акции и оценивать опционные стратегии.

Возможности

Данные по акциям

• Цены акций в реальном времени и ключевые показатели

• Исторические данные о ценах с значениями OHLC

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

• Рыночные индикаторы и коэффициенты

Анализ опционов

• Полные данные по цепочке опционов

• Греки (дельта, гамма, тета, вега)

• Отслеживание объема и открытого интереса

• Анализ опционных стратегий

Related MCP server: MCP Yahoo Finance

Установка

# Install dependencies
pip install mcp yfinance

# Clone the repository
git clone https://github.com/twolven/stockflow
cd stockflow

Использование

1. Клонируйте репозиторий:

git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

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

pip install -r requirements.txt

3. Добавьте в конфигурацию Claude: В вашем claude-desktop-config.json добавьте следующее в раздел mcpServers:

{
    "mcpServers": {
        "stockflow": {
            "command": "python",
            "args": ["path/to/stockflow.py"]
        }
    }
}

Замените "path/to/stockflow.py" на полный путь к файлу stockflow.py, который вы сохранили.

Подсказка для использования с Claude

При работе с Claude вы можете использовать эту подсказку, чтобы помочь ему понять доступные инструменты:

"Я включил инструменты stockflow, которые дают вам доступ к данным фондового рынка. Вы можете использовать эти три основные функции:

1. get_stock_data - Получить полную информацию об акциях:

{
    "symbol": "AAPL",
    "include_financials": true,  # optional
    "include_analysis": true,    # optional
    "include_calendar": true     # optional
}

2. get_historical_data - Получить историю цен и технические индикаторы:

{
    "symbol": "AAPL",
    "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
    "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
    "prepost": false       # optional - include pre/post market data
}

3. get_options_chain - Получить данные по опционам:

{
    "symbol": "AAPL",
    "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
    "include_greeks": true            # optional
}

Все ответы включают текущие данные о ценах, обработку ошибок и полную рыночную информацию."

Запуск сервера

python stockflow.py

Использование с MCP-клиентом

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )
            
            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

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

1. get-stock-data

   • Текущая цена и объем

   • Рыночная капитализация и коэффициент P/E

   • Максимум/минимум за 52 недели

2. get-historical-data

   • Цены OHLC

   • Настраиваемые временные периоды

   • Данные об объеме

3. get-options-chain

   • Коллы и путы

   • Цены страйк

   • Греки и IV

   • Объем и открытый интерес

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

1. company-info://{symbol}

   • Описание компании

   • Сектор и отрасль

   • Количество сотрудников

   • Веб-сайт

2. financials://{symbol}

   • Отчет о прибылях и убытках

   • Балансовый отчет

   • Отчет о движении денежных средств

Промпты

1. analyze-options

   • Анализ опционных стратегий

   • Оценка риска/доходности

   • Оценка рыночных условий

Требования

• Python 3.12+

• mcp

• yfinance

Ограничения

• Данные получены из Yahoo Finance и могут иметь задержки

• Доступность данных по опционам зависит от торговых часов

• Применяются ограничения скорости в зависимости от ограничений API Yahoo Finance

Вклад

Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.

Лицензия

Этот проект лицензирован под лицензией MIT — см. файл LICENSE для подробностей.

Автор

Todd Wolven — ведущий AI-разработчик ПО и инженер GenAI с открытым исходным кодом

Благодарности

• Создано с использованием Model Context Protocol (MCP) от Anthropic

• Данные предоставлены Yahoo Finance

• Разработано для использования с Claude от Anthropic