MCP Server Ccxt

🚀 Cryptocurrency Market Data MCP Server

A Model Context Protocol (MCP) server that integrates major exchanges to provide real-time and historical cryptocurrency market data. This server enables LLMs like Claude to obtain current prices, analyze market trends, and access detailed trading information.

🚀 Quick Start

This Cryptocurrency Market Data MCP Server integrates major exchanges to offer real - time and historical cryptocurrency market data, allowing LLMs such as Claude to access current prices, analyze market trends, and view detailed trading information.

✨ Features

• Real - time Market Data

  • Current cryptocurrency prices
  • Market summaries, including bid - ask spreads
  • Top - traded trading pairs by volume
  • Support for multiple exchanges

• Historical Analysis

  • OHLCV (candlestick) data
  • Price volatility analysis
  • Relationship between trading volume and time
  • Data visualization tools

• Exchange Support

  • Support for multiple mainstream cryptocurrency exchanges
  • Including Binance, Coinbase, and Huobi, etc.
  • A unified API interface is provided

📦 Installation

Install using Smithery

# To be implemented
pytest tests/

Manual Installation

1. Clone the repository:

   git clone [repository-url]
   cd cryptocurrency-mcp-server
   

2. Install dependencies:

   uv pip install -e .
   

💻 Usage Examples

Run the Server

# To be implemented
pytest tests/

Connect to Claude Desktop

1. Copy the following code to the terminal:

   uv pip install crypto-mcp-server
   

2. Start the server:

   python3 src/server.py
   

Basic Usage

Interactive Mode

• get - price
  • Function: Get price information for a specified cryptocurrency
  • Example:

    curl --location 'http://localhost:8080 getPrice' \
         --header 'Content-Type: application/json' \
         --data-raw '{
             "symbol": "BTC/USDT"
         }'
    

🔧 Technical Details

Dependency Management

• Use pipenv to manage Python dependencies
• The project root directory contains a Pipfile
• Packages to be installed include:
  • ccxt
  • flask
  • requests

Architecture Design

1. Server - side

   • Implement a RESTful API interface
   • Use the Flask framework
   • Integrate the CCXT library for data retrieval

2. Client - side

   • Provide a command - line tool
   • Support for a graphical interface (to be developed)
   • An extensible plugin system

📚 Documentation

Error Handling

Common Errors and Solutions

1. Exchange connection issues

   • Check the network status
   • Confirm that the exchange is online
   • Verify the existence of the trading pair

2. Rate limits

   • Add delays between requests
   • Use different exchanges for high - frequency queries
   • Check the specific exchange's rate - limiting policy

Troubleshooting

Common Problems

1. Data format errors

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

2. Connection timeouts

   • Check the network latency
   • Switch the API address
   • Increase the timeout setting

Development Guide

Submitting Code

1. Fork the repository:

   git clone [repository-url]
   cd cryptocurrency-mcp-server
   

2. Create a feature branch:

   git checkout -b feature/new-feature-name
   

3. Make modifications and commit:

   git add .
   git commit -m "Add new feature"
   

4. Submit a pull request

📄 License

This project is under the MIT License. For details, please refer to the LICENSE file.

Acknowledgments

• The CCXT team for providing the exchange interface
• Model Context Protocol for defining the MCP specification
• Major cryptocurrency exchanges for providing market data APIs