Crypto Multi-MCP Hub

<div align="center"> <a href="https://cryptop.coraxcolab.com" target="_blank"> <img width="800" alt="Frontend Dashboard" src="./gui/frontend/public/images/dashboard.png" style="border-radius: 12px; margin-bottom: 20px; box-shadow: 0 0 20px rgba(16, 185, 129, 0.4);" /> </a>

<h1>🌌 Crypto Multi-MCP Hub <br> <span style="font-size: 0.6em; color: #10b981;">by Corax CoLAB & PelleNybe 🚀🪙</span></h1> <h2>Hedge Fund AI Orchestrator</h2>

<p> <a href="https://github.com/PelleNybe"><img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=22&pause=1000&color=10B981&center=true&vCenter=true&width=800&lines=Welcome+to+Crypto+MCP+Server;The+Future+of+Edge+AI+%26+Blockchain;AI-driven+command+center;100%25+Real+Data+Integration;Built+with+React,+Three.js+%26+Python" alt="Typing SVG" /></a> </p>

<p> <a href="https://github.com/PelleNybe"><img src="https://img.shields.io/badge/version-3.0.0-blue.svg?style=for-the-badge&logo=github" alt="Version"/></a> <img src="https://img.shields.io/badge/python->=3.10-blue.svg?style=for-the-badge&logo=python" alt="Python"/> <img src="https://img.shields.io/badge/node->=20.x-green.svg?style=for-the-badge&logo=nodedotjs" alt="Node.js"/> <img src="https://img.shields.io/badge/React-Vite-61dafb.svg?style=for-the-badge&logo=react" alt="React"/> <img src="https://img.shields.io/badge/Three.js-3D-black.svg?style=for-the-badge&logo=three.js" alt="Three.js"/> <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="License"/> </p>

<p><em>The ultimate AI-driven command center and Multi-MCP Hub for your local crypto operations, featuring a dark, cyberpunk/command-center aesthetic. Built for everyone, from homebrew Raspberry Pi setups to cloud servers.</em></p> </div>

---

👨‍💻 Developer & Company

<div align="center"> <img src="https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg" width="100%" height="2" onerror="this.style.display='none'"/> </div>

<p align="center"> This project is brought to you by <strong>Pelle Nyberg</strong> and his company, <strong>Corax CoLAB</strong>. </p>

<div align="center"> <table> <tr> <td align="center" width="50%"> <h3><a href="https://pellenybe.github.io" target="_blank">Pelle Nyberg</a></h3> <p>Lead Developer & Architect</p> <a href="https://github.com/PelleNybe"><img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"/></a> <a href="https://www.linkedin.com/in/pellenyberg/"><img src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn"/></a> <a href="https://pellenybe.github.io"><img src="https://img.shields.io/badge/Portfolio-FF5722?style=for-the-badge&logo=Web&logoColor=white" alt="Portfolio"/></a> </td> <td align="center" width="50%"> <h3><a href="https://coraxcolab.com" target="_blank">Corax CoLAB</a></h3> <p>Innovation & AI Solutions</p> <a href="https://coraxcolab.com"><img src="https://img.shields.io/badge/Website-000000?style=for-the-badge&logo=Google-Chrome&logoColor=white" alt="Website"/></a> <a href="https://cryptop.coraxcolab.com"><img src="https://img.shields.io/badge/Crypto_Hub_Live-10B981?style=for-the-badge&logo=planet&logoColor=white" alt="Live Project"/></a> </td> </tr> </table> </div>

<div align="center"> <img src="https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg" width="100%" height="2" onerror="this.style.display='none'"/> </div>

---

✨ Features & Capabilities

🎨 Visual & Technical Upgrades (Bolt & Palette)

• Matrix Digital Rain: Ambient, immersive cyberpunk background animations.
• Cyberpunk Glitch Text: Immersive text glitching effects across core UI headers.
• Interactive 3D Card Tilt: Hover over dashboard elements to see them dynamically tilt in 3D space.
• Holographic Sweeps: Primary buttons feature an animated light-sweep effect to represent active scanning.
• Typewriter AI Reasoning: AI logic is animated character-by-character for a more authentic 'terminal' feel.
• Performance & Security: Includes memoized 3D components, SSRF protection on endpoints, error-fallback for ERC20 contracts, and hmac.compare_digest for timing-safe equality in backend services.

Our terminal is a living, breathing Hedge Fund AI Orchestrator, packed with cutting-edge tools.

🤖 Autonomous Orchestrator Mode (Agentic Loop)

Evolving from a passive Multi-MCP tool, the server acts as an autonomous 24/7 trading agent framework running a continuous Observe-Analyze-Act (OODA) loop.

• Observe (gather_market_data): Queries multiple MCPs (e.g. Technical indicators, News sentiment, On-chain data).
• Analyze (analyze_with_llm): Evaluates signals using an LLM (Gemini, Claude, or OpenAI) for a structured decision (BUY, SELL, HOLD).
• Act (execute_trade): Executes trades via the local CCXT MCP.
• Agentic Backtesting: Safely test AI prompts and models against historical OHLCV data without risking real funds.
• Proof of Brain (Trading Diary): Comprehensive markdown reports detailing the "Board of Directors" reasoning for every action taken.

📱 Telegram Command Center

Receive real-time alerts and command your trading agent via Telegram.

• /status: View active AI providers and last decisions.
• /report: Receive your latest "Proof of Brain" report.
• /analyze: Trigger a manual OODA cycle.

🌌 100% Real Data Integration & Visualizer Dynamics (v3.0)

The Crypto MCP Server uses real data across all visualizers. The entire system operates without a single mockup!

• 🎯 Dark Pool Sonar: Real-time 3D sonar pings for large volume "whale" trades on central exchanges using @react-three/fiber.
• 🔥 Flash-Crash Prediction Matrix: Glowing heatmap grid of bids to asks, tracking liquidity drains.
• 🚀 Galaxy View (Gravity Well): 3D mapping of the top 50 cryptocurrencies.
• 🧠 AI Sentiment Word-Cloud Sphere: Extracts trending keywords and sentiment from real-time news to form an interactive 3D floating sphere.
• ⚡ Gas & Network Congestion Hologram: Visualizes Ethereum network congestion as a glowing, pulsating reactor core.

---

🚀 The Multi-MCP Ecosystem

This repository comes bundled with over a dozen powerful MCPs (Model Context Protocol). They provide execution, raw data, analysis, and external system integrations.

<details> <summary><b>🛠️ View Included MCPs (Click to expand)</b></summary> <br>

MCP Server	Description	Port
ccxt_mcp	The core exchange trading & market data integration via CCXT.	7001
onchain_mcp	ETH balances, ERC20 balances, transaction info, and live Gas Prices.	7002
ta_mcp	Compute Technical Indicators (RSI, MACD, SMA50, BB) and Monte Carlo Simulations.	7003
portfolio_mcp	Aggregated portfolio balances and performance tracking.	7004
coingecko_mcp	Deep market stats, top coins, and historical trends.	7005
llm_mcp	Local/Remote LLM operations and Copilot interactions.	7006
notifier_mcp	System notifications, alerts, and Telegram broadcasting.	7007
freqtrade_mcp	Interfaces with local Freqtrade instances via REST APIs.	7011
octobot_mcp	Interfaces with local OctoBot instances via REST APIs.	7012
hummingbot_mcp	Controls local Hummingbot Gateway APIs.	7013
superalgos_mcp	Interacts with the Superalgos platform API.	7014
news_mcp	Fetches the latest crypto news from CryptoPanic.	7017

</details>

---

🗺️ System Overview & Architecture

Explore the architecture, installation success, and security models below:

<details> <summary><b>1️⃣ Architectural Overview (Click to expand)</b></summary> <br> Claude Desktop communicates via JSON-RPC with the Crypto MCP Server backend (REST + WebSocket). The server acts as a proxy, directing traffic to specific local MCP tools—such as CCXT, CoinGecko, and Portfolio—while logging orders to a local SQLite database.

<div align="center"> <img width="800" alt="Architectural Overview" src="./gui/frontend/public/images/architecture.jpg" style="border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);" onerror="this.style.display='none'" /> </div> </details>

<details> <summary><b>2️⃣ Installation and Configuration (Click to expand)</b></summary> <br> The terminal displays successful execution steps of the automated install.sh script, automating directory creation, Node.js installation, and service setup.

<div align="center"> <img width="800" alt="Installation and Configuration" src="./gui/frontend/public/images/installation.jpg" style="border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);" onerror="this.style.display='none'" /> </div> </details>

<details> <summary><b>3️⃣ Security and Best Practices (Click to expand)</b></summary> <br> Summarizes the core security principles: using testnet keys, securing API keys, restricting network access, leveraging local control, and implementing an authenticated reverse proxy.

<div align="center"> <img width="800" alt="Security and Best Practices" src="./gui/frontend/public/images/security.jpg" style="border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);" onerror="this.style.display='none'" /> </div> </details>

---

✅ Quick start — automated

Place the provided install.sh into $HOME/install.sh (or $HOME/cryptomcpserver/install.sh if you prefer). Make it executable and run it:

# Save install.sh to $HOME/install.sh, then:
cd $HOME
chmod +x install.sh
./install.sh

What install.sh does (summary):

1. Creates directories and writes backend & frontend files.
2. Installs Node.js if missing and runs npm install for backend & frontend.
3. Ensures the orders table exists in $HOME/cryptomcpserver/gui/backend/orders.db.
4. Frees port 4000 if occupied, then installs & enables the systemd service crypto-mcp-gui.service.
5. Attempts a production build of the frontend.

After running, check service status and logs:

sudo systemctl status crypto-mcp-gui.service
sudo journalctl -u crypto-mcp-gui.service -f

---

🛠 Manual install

If you prefer to do everything yourself:

1. Install system deps & Python Requirements:

   sudo apt update
   sudo apt install -y curl build-essential ca-certificates git python3-pip
   pip3 install -r requirements.txt
   

2. Install Node.js (if needed):

   curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
   sudo apt install -y nodejs
   

3. Backend & Global Config:

   cd $HOME/cryptomcpserver
   cp .env.example .env
   # edit .env to add your passwords, keys, and allowed pairs
   
   cd gui/backend
   npm install
   

4. Frontend (dev):

   cd $HOME/cryptomcpserver/gui/frontend
   npm install
   npm run dev -- --host   # open http://PI_IP:5173 on your laptop
   

5. Systemd (backend):

   # Create /etc/systemd/system/crypto-mcp-gui.service
   sudo systemctl daemon-reload
   sudo systemctl enable --now crypto-mcp-gui.service
   

---

⚙️ Configuration

The system uses a centralized .env file located at the root of the project to manage both Python MCP servers and the Node.js backend.

Copy and edit $HOME/cryptomcpserver/.env.example → .env:

# Essential configuration
PORT=4000
DASHBOARD_PASSWORD=your_secure_password # Required for trading and AI reasoning
ALLOWED_PAIRS=BTC/USDT,SOL/USDT # Fail-closed security: only these pairs are allowed
MAX_TRADE_USD=100.0 # Maximum allowed trade amount per transaction

# API Keys
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

# --- Autonomous Orchestrator Settings ---
ACTIVE_LLM_PROVIDER="gemini"
GEMINI_API_KEY="your_google_gemini_key_here"
TELEGRAM_BOT_TOKEN="your_token_here"
TELEGRAM_CHAT_ID="your_chat_id_here"

---

🔗 Claude Desktop integration

Add MCP servers in Claude Desktop (step-by-step)

1. Open Claude Desktop app.
2. Open App Settings / Preferences.
3. Find Local MCP Servers.
4. Click + (Add) — fill fields one by one:
   • Name: ccxt
   • Description: CCXT MCP – exchange trading & market data
   • Transport: http
   • Endpoint: http://127.0.0.1:7001/mcp (if Claude runs on Pi) or http://<pi-ip>:7001/mcp (if Claude runs on laptop)
5. Save. Repeat for other MCPs (coingecko, portfolio, onchain, ta, news, etc.) with their respective ports.

---

🖥 Dashboard user manual

• 📊 Portfolio: View aggregated balances & USD value.
• 📈 Ticker: Live market data (via ccxt MCP).
• 🛒 Order / Trade:
  • Preview (dry_run): Calculates estimated cost and logs a preview.
  • Confirm → Place order: Sends create_order to CCXT MCP.
• 📜 Orders log: Real-time updates via socket.io, paginated with indices.
• 🤖 AI Copilot: Voice-activated command center powered by local LLMs.

⚠️ Safety: Always test with testnet keys. The UI requires confirmation to execute live orders.

---

🔒 Security & best practices

• Testnet First: Use testnet keys while testing.
• Environment Variables: Keep API keys out of repo.
• Network Isolation: Restrict access to MCP endpoints to LAN only.
• Authentication: Endpoints are fully secured with DASHBOARD_PASSWORD verification.

<div align="center"> <img src="https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg" width="100%" height="2" onerror="this.style.display='none'"/> <p><i>Stay Cypherpunk. Keep Building. ⚡</i></p> </div>