Python-Based-MCP-Server-for-Crypto-Market-Data

# 🚀 MCP Crypto Server ### Real-Time Cryptocurrency Data Platform     --- ## 📌 Overview The **MCP Crypto Server** is a production-ready backend system built using **FastAPI** that provides: * 📊 Real-time cryptocurrency market data * 📈 Historical OHLCV data * ⚡ WebSocket-based live updates * 🧠 Intelligent caching (in-memory / Redis-ready) * 🌐 Interactive HTML dashboard Designed with **scalable architecture**, this project is suitable for both **local development** and **production deployment**. --- ## 🏗️ Architecture ```id="arch001" Client (Browser / API) ↓ FastAPI Server (MCP) ↓ Service Layer (CCXT) ↓ Crypto Exchanges (Binance, etc.) ↓ Cache Layer (In-Memory / Redis) ``` --- ## ⚙️ Tech Stack | Layer | Technology | | ----------- | ----------------------- | | Backend | FastAPI | | Data Source | CCXT | | Realtime | WebSockets | | Caching | In-Memory (Redis-ready) | | Frontend | HTML + JavaScript | | Testing | Pytest | | Deployment | Docker (optional) | --- ## 📁 Project Structure ```id="struct001" mcp-crypto-server/ │ ├── app/ │ ├── main.py │ ├── core/ │ ├── api/routes/ │ ├── services/ │ ├── websocket/ │ ├── cache/ │ ├── templates/ │ └── index.html │ ├── static/ │ └── app.js │ ├── tests/ ├── requirements.txt ├── Dockerfile ├── docker-compose.yml └── .env ``` --- ## 🐍 Virtual Environment Setup ### 🔹 Create Virtual Environment ```bash id="venv1" python -m venv venv ``` --- ### 🔹 Activate Virtual Environment #### ▶️ Windows (CMD) ```bash id="venv2" venv\Scripts\activate ``` #### ▶️ Windows (PowerShell) ```bash id="venv3" venv\Scripts\Activate.ps1 ``` #### ▶️ Linux / macOS ```bash id="venv4" source venv/bin/activate ``` --- ### 🔹 Deactivate ```bash id="venv5" deactivate ``` --- ## 🔧 Setup & Installation ### 1️⃣ Clone Repository ```bash id="setup1" git clone <your-repo-url> cd mcp-crypto-server ``` --- ### 2️⃣ Install Dependencies ```bash id="setup2" pip install -r requirements.txt ``` --- ### 3️⃣ Configure Environment Create `.env` file: ```env id="setup3" SYMBOL=BTC/USDT ``` --- ### 4️⃣ Run the Server ```bash id="setup4" python -m uvicorn app.main:app --reload ``` --- ## 🌐 Usage ### 🔹 Dashboard ``` http://127.0.0.1:8000 ``` ### 🔹 API Docs ``` http://127.0.0.1:8000/docs ``` --- ## 📡 API Endpoints ### ▶️ Get Market Data ``` GET /market/ticker?symbol=BTC/USDT ``` ### ▶️ WebSocket ``` ws://localhost:8000/ws ``` --- ## 🧪 Running Tests ```bash id="test1" pytest ``` --- ## 🐳 Docker (Optional) ```bash id="docker1" docker-compose up --build ``` --- ## 🚀 Features * ✅ Real-time crypto streaming * ✅ REST API endpoints * ✅ WebSocket multi-client support * ✅ Modular clean architecture * ✅ Error handling & logging * ✅ Docker-ready * ✅ Environment configuration --- ## ⚠️ Notes * Redis is optional (in-memory cache used locally) * Internet required for live data * Easily extendable for multi-exchange support --- ## 🚀 Future Improvements * 📊 Charts (Chart.js / TradingView) * 🔐 Authentication (JWT) * 🌍 Multi-coin dashboard * ☸️ Kubernetes deployment * 📈 Monitoring (Grafana) --- ## 💼 Resume Highlight > Built a production-ready crypto market data server using FastAPI, WebSockets, and CCXT with real-time streaming, caching, and scalable architecture. --- ## 👨‍💻 Author **Biswajit Andia** MCA Student | Backend & DevOps Enthusiast --- ## 📜 License # 📜 MIT License Copyright (c) 2026 **Biswajit Andia** --- ## 🔓 Permission Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the **"Software"**), to deal in the Software without restriction, including without limitation the rights to: * ✅ Use * ✅ Copy * ✅ Modify * ✅ Merge * ✅ Publish * ✅ Distribute * ✅ Sublicense * ✅ Sell copies --- ## 📌 Conditions The above copyright notice and this permission notice shall be included in: * All copies of the Software * Substantial portions of the Software --- ## ⚠️ Disclaimer THE SOFTWARE IS PROVIDED **"AS IS"**, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF: * MERCHANTABILITY * FITNESS FOR A PARTICULAR PURPOSE * NON-INFRINGEMENT IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --- ## 🚀 Summary This project is: * 🔓 Open-source * 🧠 Free to use * 🛠️ Free to modify * 💼 Safe for personal & commercial use --- 💡 *Built with passion by Biswajit Andia* <img width="1914" height="988" alt="image" src="https://github.com/user-attachments/assets/f5b0af8c-1cb8-473b-8e1c-e6a0c5baab37" />