MCP Server Omkar

MCP Server — Omkar

Minimal Python MCP server for cryptocurrency market data (FastAPI + CCXT)

What's included

• FastAPI server with REST endpoints and a websocket broadcast endpoint
• app/exchanges.py CCXT wrapper (public endpoints only)
• Simple async TTL cache
• Utilities (retry, error handling)
• Tests (pytest, pytest-asyncio) that mock exchange calls
• CI workflow example for running tests

Quickstart

python -m venv .venv
source .venv/bin/activate     # or .venv\Scripts\activate on Windows
pip install -r requirements.txt

# run server
uvicorn app.main:app --reload --port 8000

# run tests
pytest -q

Endpoints (examples)

• GET /health — basic healthcheck
• GET /ticker?exchange=binance&symbol=BTC/USDT — latest ticker for symbol
• GET /history?exchange=binance&symbol=BTC/USDT&since=1630454400000&limit=100 — OHLCV history (ms timestamp)
• WebSocket /ws/ticker — subscribe to periodic ticker updates (send JSON with exchange & symbol)

Assumptions

• Public market endpoints only; no API keys required.
• Uses polling for realtime broadcasting to keep it cross-exchange.
• Tests mock exchange calls so CI doesn't need network access.