ghiemer/cryptocurrency_data_mcp

📊 Crypto Data MCP Server

A modern MCP server for crypto data analysis. Built for speed, multi-exchange coverage, and actionable insights.

✨ Why Use It?

• 🔄 Multi-Exchange Ready – Binance, Bybit, OKX (spot, futures, swap)
• 📊 Technical Indicators – SMA, EMA, RSI, MACD, Bollinger Bands & more
• 📡 Live Market Data – OHLCV candles, orderbooks, depth
• 📰 News & Sentiment – CryptoPanic, NewsAPI, Fear & Greed Index
• 🛠 Production-Ready – Docker, FastMCP v2, logging, retry logic, rate-limiting

🚀 Quick Start

Docker (recommended)

git clone https://github.com/ghiemer/cryptocurrency_data_mcp
cd cryptocurrency_data_mcp

docker compose build
docker compose up -d
# Server is live at http://localhost:8000

Local

pip install -r app/requirements.txt
python -m app.main

📡 API Tools

All endpoints follow the Model Context Protocol.

• Candles → fetch_candles (with optional indicators)
• Orderbook → fetch_orderbook
• News → fetch_news
• Sentiment → fetch_feargreed, fetch_cryptopanic

Example:

{
  "name": "fetch_candles",
  "arguments": {
    "symbol": "XRP/USDT",
    "timeframe": "1h",
    "limit": 100,
    "exchange": "binance",
    "market_type": "spot",
    "indicators": { "sma": 20, "rsi": 14 }
  }
}

⚙️ Configuration

Create a .env file:

LOG_LEVEL=INFO
PORT=8000
NEWSAPI_KEY=your_newsapi_key
CRYPTOPANIC_KEY=your_cryptopanic_key

Symbols auto-map across markets:

📊 Supported Exchanges

🛠 Project Structure

cryptocurrency_data_mcp/
├── app/
│   ├── main.py              # FastMCP server & tools
│   ├── data_fetch.py        # Exchange data fetcher
│   ├── indicator_engine.py  # Technical indicators
│   ├── utils.py             # Helpers & error handling
│   └── requirements.txt
├── .env                     # Environment variables
├── docker-compose.yml
└── Dockerfile

📈 Performance

• 🚦 Rate-limit aware (CCXT)
• ⚡ Stream-based data for memory efficiency
• 🔄 Retries & recovery on failure
• 🗂 Caching for smart reuse

🔐 Security

• 🔑 Secure API keys via .env
• 🛡 Input validation + error isolation
• 📉 Built-in rate limiting

🤝 Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit (git commit -m "Add new feature")
4. Push (git push origin feature/my-feature)
5. Open a Pull Request

📜 License

MIT License – see .

🆘 Support

• GitHub Issues
• FastMCP Docs
• CCXT Docs

🎯 Roadmap

• Real-time WebSocket streams
• Portfolio tracking
• ML-powered price predictions

Built with ❤️ on FastMCP | Powered by CCXT | Docker Ready 🐳