MCP Crypto Market Data Server

MCP Crypto Market Data Server

This project is a Python-based MCP server that provides real-time and historical cryptocurrency market data. The server is built using FastAPI, and it fetches data from major exchanges through CCXT. The goal of this project was to understand how MCP servers work, how to interact with crypto APIs, and how to build a clean, modular Python backend.

*Why I Built It

The assignment required a small MCP server with features like:

endpoints to fetch data

support for real-time updates

historical queries

caching

structured code

test coverage

I kept the code simple so anyone can read it easily, while still keeping the structure clean.

*Features Implemented

Live price lookup

Historical OHLCV (1 hour candles, last 24 hours)

Lightweight caching

Error handling

Tests using pytest

Clean folder structure

**Project Structure

mcp-server/ ├─ app/ │ ├─ main.py │ ├─ services/ccxt_client.py │ ├─ cache.py │ ├─ models.py │ └─ exceptions.py ├─ tests/test_api.py ├─ requirements.txt └─ README.md

***Technologies Used

FastAPI

CCXT

Pytest

Uvicorn

Python

**Endpoints

1. Root GET / Response: { "message": "Crypto MCP Server running" }

2. Latest Price GET /price/{symbol} Example: /price/BTC

3. Historical OHLCV GET /history/{symbol} Example: /history/ETH

***How to Run

1. Install dependencies pip install -r requirements.txt

2. Start the server uvicorn app.main:app --reload

3. Test API http://127.0.0.1:8000/price/BTC http://127.0.0.1:8000/history/ETH

4. Run Tests pytest

***Assumptions

Binance is the default exchange.

Symbols assumed to trade against USDT.

Cache expiry: 10 seconds.

Historical timeframe: 1h.

***Possible Improvements

Support multiple exchanges

WebSocket streaming

Redis caching

More detailed tests

Environment variables

Conclusion

This project meets the MCP assignment requirements with clear Python code, real-time crypto data, historical queries, caching, structured layout, and test coverage.