ark-market-data-mcp

# Ark Market Data MCP An MCP (Model Context Protocol) server that streams real-time market data to Claude via WebSocket connection. ## Features - **Real-time Market Data Streaming** - Connects to a WebSocket server and buffers incoming market data - **OHLCV History** - Aggregates live stream into 1m/5m candles persisted to a local SQLite database - **Historical Seeding** - One-command backfill from Binance (default 6 months, fully configurable) - **MCP Integration** - Works seamlessly with Claude via the Model Context Protocol - **Configurable WebSocket URL** - Supports environment variable configuration for flexible deployment - **In-memory Buffering** - Efficiently buffers up to 500 messages with configurable size - **Auto-reconnect** - Automatically reconnects on connection failures with exponential backoff ## Installation ### Via PyPI ```bash pip install ark-market-data-mcp ``` ### From Source ```bash git clone https://github.com/arkhamides/mcp-market-data.git cd ark-market-data-mcp python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -e . ``` ## Quick Start ### 1. Set up your WebSocket endpoint ```bash export WS_URI=ws://your-websocket-url.com ``` ### 2. Add to Claude ```bash claude mcp add ark-market-data ark-market-data-mcp ``` ### 3. Use with Claude ```bash claude chat ``` Ask Claude to use the market data tools, e.g., "What's the latest market data?" ## Seeding Historical Data Before running backtests, seed the local database with historical candles from Binance. ```bash # Install the historical extra pip install ark-market-data-mcp[historical] # or just: pip install ccxt # Default: BTC/USDT, 1m candles, last 6 months python scripts/seed_historical.py # Custom symbol / resolution python scripts/seed_historical.py --symbol ETH/USDT --resolution 5m # Custom date range python scripts/seed_historical.py --start 2024-01-01 --end 2024-07-01 # Custom look-back window python scripts/seed_historical.p…