CCXT MCP Server

High-performance cryptocurrency exchange integration using MCP (Model Context Protocol) and CCXT.

Features

• 🚀 Exchange Support: Connects to 20+ cryptocurrency exchanges
• 🔃 Market Types: Supports spot, futures, swap markets and more
• 🔧 Proxy Configuration: Options for accessing exchanges through proxies
• 📊 Fast & Reliable: Optimized caching and rate limiting
• 🌐 MCP Standard: Compatible with LLMs like Claude and GPT via MCP

CCXT MCP Server Integration Architecture

The CCXT MCP Server connects language models to cryptocurrency exchanges through the Model Context Protocol. It serves as a bridge that allows LLMs to access real-time market data and execute trading operations across multiple exchanges through a unified API.

The architecture includes:

• LLM clients (Claude and other MCP-compatible models) that send requests
• The Model Context Protocol (MCP) that standardizes communication
• The CCXT MCP Server that processes requests and manages exchange interactions
• The CCXT Library that provides unified access to exchange APIs
• Connections to multiple cryptocurrency exchanges

CCXT MCP Server Code Architecture

The server is organized into three main modules for better maintainability and extensibility:

• Exchange: Manages exchange instances, credentials, and symbol validation
• Utils: Provides caching, rate limiting, and logging functionality
• Tools: Implements MCP tools and resources for exchange interaction

Quick Start

Installing via Smithery

To install mcp-server-ccxt for Claude Desktop automatically via Smithery:

NPM Package (Recommended)

You can install CCXT MCP Server from npm:

Or run directly:

Manual Installation

Alternatively, you can clone and build the repository:

Configuration

1. Create an environment file
   cp .env.example .env
2. Edit the .env file to add your exchange API keys
   # Default exchange (optional) DEFAULT_EXCHANGE=binance # Default market type (optional) DEFAULT_MARKET_TYPE=spot # API credentials (optional) BINANCE_API_KEY=your_api_key BINANCE_SECRET=your_api_secret # Proxy configuration (optional) USE_PROXY=false PROXY_URL=http://username:password@your-proxy-server:port # Legacy format (still supported but recommended to use the integrated URL format above) # PROXY_USERNAME= # PROXY_PASSWORD=

Usage

Note: If you encounter any issues with MCP communication, please see the Troubleshooting Guide for solutions.

Running the Server

Start the server:

Using with Claude for Desktop

1. Add the server to your claude_desktop_config.json:

If installed via npm (globally):

If installed manually:

2. Restart Claude for Desktop

Using as a Module in Another Project

You can also use this package as a module in your own Node.js projects:

Example Queries

Here are some example queries you can use with the MCP server:

• "What's the current price of Bitcoin on Binance?"
• "Show me the order book for ETH/USDT on Coinbase"
• "Get the 1-hour OHLCV data for BTC/USDT on Binance for the last 24 candles"
• "Compare the price of SOL/USDT across different exchanges"
• "What's my current balance on Binance?" (requires API keys)
• "Place a market buy order for 0.1 ETH on Kraken" (requires API keys)

Available Tools

Public API Tools

• list-exchanges: List all available cryptocurrency exchanges
• get-ticker: Get current ticker information for a trading pair
• batch-get-tickers: Get ticker information for multiple trading pairs at once
• get-orderbook / get-order-book: Get market order book for a trading pair
• get-ohlcv: Get OHLCV candlestick data for a trading pair
• get-trades: Get recent trades for a trading pair
• get-markets: Get all available markets for an exchange
• get-exchange-info: Get exchange information and status
• get-leverage-tiers: Get futures leverage tiers
• get-funding-rates: Get current funding rates
• get-positions: Get open positions information
• get-open-orders: Get all open orders
• get-order-history: Get order history

Private API Tools (requires API keys)

• account-balance: Get your account balance from a crypto exchange
• place-market-order: Place a market order on an exchange
• place-limit-order: Place a limit order on an exchange
• cancel-order: Cancel an existing order
• cancel-all-orders: Cancel all open orders
• set-leverage: Set leverage for futures
• set-margin-mode: Set margin mode for futures
• place-futures-market-order: Place futures market orders
• place-futures-limit-order: Place futures limit orders
• transfer-funds: Transfer funds between accounts (e.g., spot to futures)

Configuration & Utility Tools

• cache-stats: Get CCXT cache statistics
• clear-cache: Clear CCXT cache
• set-log-level: Set logging level
• get-proxy-config: Get proxy settings
• set-proxy-config: Configure proxy settings
• set-market-type: Set default market type
• set-default-exchange: Change the default exchange
• system-info: Get system and environment information

Performance Optimizations

MCP-CCXT includes several optimizations to ensure high performance:

1. LRU Caching System:
   • Different TTLs for different types of data
   • Ticker data: 10 seconds
   • Order book data: 5 seconds
   • Market data: 1 hour
2. Adaptive Rate Limiting:
   • Automatically adjusts request rates based on exchange responses
   • Implements exponential backoff for errors
   • Manages concurrent requests per exchange
3. Exchange Connection Management:
   • Efficient initialization of exchange instances
   • Proper error handling and retries

Security Best Practices

API Key Security

1. Create Dedicated API Keys:
   • Create separate API keys for different applications/purposes
   • Never reuse API keys across different services or applications
2. Limit API Key Permissions:
   • Enable only the permissions you need (e.g., read-only for market data)
   • Disable withdrawal permissions if you only need trading functionality
   • Use IP whitelisting when available to restrict access to known IPs
3. Secure Storage:
   • Never commit API keys to version control systems
   • Store API keys in environment variables or a secure vault
   • Use .env files that are excluded from git via .gitignore

Risk Disclaimer

This software is provided for informational purposes only. Using this software to interact with cryptocurrency exchanges involves significant risks:

• Financial Risk: Cryptocurrency trading involves risk of loss
• API Security: Ensure your API keys have appropriate permission limits
• No Investment Advice: This tool does not provide investment advice
• No Warranty: The software is provided "as is" without warranty of any kind

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Copyright and Attribution

This project uses the CCXT library (https://github.com/ccxt/ccxt), which is:

CCXT is released under the MIT License, which is included below:

For issues, feature requests, or contributions, please visit the GitHub repository.