Nayshins MCP Server Ccxt

🚀 Cryptocurrency Market Data MCP Server

A Model Context Protocol (MCP) server that provides real-time and historical cryptocurrency market data by integrating with major exchanges. This server enables large language models like Claude to obtain current prices, analyze market trends, and access detailed trading information.

🚀 Quick Start

This Cryptocurrency Market Data MCP Server provides real - time and historical market data for large language models. You can install and use it according to the following steps.

✨ Features

• Real - time Market Data

  • Current cryptocurrency prices
  • Market summaries, including bid - ask spreads
  • Top trading pairs with the highest trading volumes
  • Support for multiple exchanges

• Historical Analysis

  • OHLCV (candlestick) data
  • Price change statistics
  • Historical trading volume tracking
  • Customizable time periods

• Exchange Support

  • Binance
  • Coinbase
  • Kraken
  • KuCoin
  • HyperLiquid
  • Huobi
  • Bitfinex
  • Bybit
  • OKX
  • MEXC

📦 Installation

# Use uv (recommended)
uv pip install mcp ccxt

# Use pip
pip install mcp ccxt

💻 Usage Examples

Basic Usage

Run the Server

python crypto_server.py

Connect with Claude Desktop

1. Open your Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

{
  "servers": {
    "crypto-mcp-server": {
      "type": "mcp",
      "uri": "http://localhost:5000"
    }
  }
}

3. Restart Claude Desktop to apply the changes.

Advanced Usage

Real - time Price Query

>>> from crypto_mcp_server import MarketData
>>> client = MarketData()
>>> print(client.get_current_price("BTC/USDT"))
45000.25

Historical Data Retrieval

>>> print(client.get_historical_data("ETH/USDT", "1D"))
[
    [1625932800, 2700.0, 2720.0, 2680.0, 2710.0, 456.25],
    ...
]

🔧 Technical Details

• Written in Python
• Implemented based on the MCP protocol
• Integrated the CCXT library for exchange data interaction
• Supports multi - threading to handle high - concurrency requests

📚 Documentation

Troubleshooting

Common Issues

1. Exchange connection errors

   • Check your internet connection
   • Confirm that the exchange is in a normal state
   • Verify that the trading pair exists on the selected exchange

2. Rate limits

   • Add a delay between requests
   • Use different exchanges to handle high - frequency queries
   • Check the specific rate limits of each exchange

3. Data format issues

   • Confirm that the trading pair format is correct (e.g., BTC/USDT, not BTCUSDT)
   • Check the time period specification
   • Ensure that numerical parameters are within the valid range

📄 License

This project is under the MIT License. Please refer to the LICENSE file for detailed information.

Acknowledgments

• CCXT for exchange integration
• Model Context Protocol for the MCP specification
• Various cryptocurrency exchanges for providing market data APIs