MCP Server Ccxt

7 forks

17 stars

Free

What is mcp-server-ccxt

mcp-server-ccxt is a robust tool developed by Nayshins that leverages the Model Context Protocol (MCP) to offer comprehensive access to cryptocurrency market data. It provides real-time and historical data by integrating with major cryptocurrency exchanges. This server is particularly useful for large language models (LLMs) like Claude, enabling them to fetch current prices, analyze market trends, and access detailed trading information efficiently.

How to Use mcp-server-ccxt

To get started with mcp-server-ccxt, you can install it using a package manager or manually. After installation, you can run the server and connect it with an AI platform like Claude Desktop.

Installation Steps

Automatic Installation via Smithery:

Use the command:

npx -y @smithery/cli install mcp-server-ccxt --client claude

Manual Installation:
- Use pip to install necessary packages:
```
pip install mcp ccxt
```

Running the Server

Start the server with the command:
```
python crypto_server.py
```
Connect the server to Claude Desktop by modifying the configuration file to include the server details and restarting the application.

Usage Commands

Once set up, you can use various commands to interact with the server:

get-price: Retrieve current prices for trading pairs.
get-market-summary: Access detailed market summaries.
get-top-volumes: List top trading pairs by volume.
list-exchanges: Display supported exchanges.
get-historical-ohlcv: Fetch historical candlestick data.
get-price-change: Calculate price changes over specific timeframes.
get-volume-history: Track trading volume history.

Key Features of mcp-server-ccxt

mcp-server-ccxt is packed with features designed to provide comprehensive market data:

Real-time Market Data: Access current prices, bid/ask spreads, and top trading pairs across multiple exchanges, including Binance, Coinbase, Kraken, and more.
Historical Analysis: Utilize OHLCV data for detailed analysis, track price changes, and review volume history with customizable timeframes.
Extensive Exchange Support: The server integrates with a wide range of exchanges such as Binance, Coinbase, Kraken, KuCoin, and others, ensuring broad accessibility to market data.
Efficient Data Handling: Built with error handling to manage invalid trading pairs, connectivity issues, rate limiting, and other common challenges.
Secure and Flexible: Leverages the MCP framework to ensure secure and standardized data exchange between the server and AI clients.

Using mcp-server-ccxt, users can effectively manage and analyze cryptocurrency market data, making it an essential tool for developers and analysts in the finance and AI sectors.

A Model Context Protocol (MCP) server that provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information. MCP Python CCXT

Features

Real-time Market Data
Current cryptocurrency prices
Market summaries with bid/ask spreads
Top trading pairs by volume
Multiple exchange support
Historical Analysis
OHLCV (candlestick) data
Price change statistics
Volume history tracking
Customizable timeframes
Exchange Support
Binance
Coinbase
Kraken
KuCoin
HyperLiquid
Huobi
Bitfinex
Bybit
OKX
MEXC

Installation

Installing via

To install Cryptocurrency Market Data Server for Claude Desktop automatically via :

npx -y @/cli install mcp-server-ccxt --client claude

Installing Manually

# Using uv (recommended)
uv pip install mcp ccxt
# Using pip
pip install mcp ccxt

Usage

Running the Server

python crypto_server.py

Connecting with Claude Desktop

Open your Claude Desktop configuration at:

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

Add the server configuration:

 "mcpServers": {
 "crypto": {
 "command": "python",
 "args": ["/path/to/crypto_server.py"]

Restart Claude Desktop

Available Tools

get-price

Get current price for any trading pair
Example: "What's the current price of BTC/USDT on Binance?"

get-market-summary

Fetch detailed market information
Example: "Show me a market summary for ETH/USDT"

get-top-volumes

List top trading pairs by volume
Example: "What are the top 5 trading pairs on Kraken?"

list-exchanges

Show all supported exchanges
Example: "Which exchanges are supported?"

get-historical-ohlcv

Get historical candlestick data
Example: "Show me the last 7 days of BTC/USDT price data in 1-hour intervals"

get-price-change

Calculate price changes over different timeframes
Example: "What's the 24-hour price change for SOL/USDT?"

get-volume-history

Track trading volume over time
Example: "Show me the trading volume history for ETH/USDT over the last week"

Example Queries

Here are some example questions you can ask Claude once the server is connected:

- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?

Technical Details

Dependencies

mcp: Model Context Protocol SDK
ccxt: Cryptocurrency Exchange Trading Library
Python 3.9 or higher

Architecture

The server uses:

CCXT's async support for efficient exchange communication
MCP's tool system for LLM integration
Standardized data formatting for consistent outputs
Connection pooling for optimal performance

Error Handling

The server implements robust error handling for:

Invalid trading pairs
Exchange connectivity issues
Rate limiting
Malformed requests
Network timeouts

Development

Running Tests

# To be implemented
pytest tests/

Contributing

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

Local Development

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server
# Install dependencies
uv pip install -e .

Troubleshooting

Common Issues

Exchange Connection Errors

Check your internet connection
Verify the exchange is operational
Ensure the trading pair exists on the selected exchange

Rate Limiting

Implement delays between requests
Use different exchanges for high-frequency queries
Check exchange-specific rate limits

Data Formatting Issues

Verify trading pair format (e.g., BTC/USDT, not BTCUSDT)
Check timeframe specifications
Ensure numerical parameters are within valid ranges

License

MIT License - See LICENSE file for details

Acknowledgments

CCXT for exchange integrations
Model Context Protocol for the MCP specification
The cryptocurrency exchanges for providing market data APIs

How to Use

To use the mcp-server-ccxt, follow these steps:

Visit https://github.com/Nayshins/mcp-server-ccxthttps://github.com/Nayshi...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using mcp-server-ccxt capabilities within your Claude conversations

Additional Information

Created

December 24, 2024

Company

Nayshins

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More

MCP Server Ccxt

What is mcp-server-ccxt

How to Use mcp-server-ccxt

Installation Steps

Running the Server

Usage Commands

Key Features of mcp-server-ccxt

Features

Installation

Installing via

Installing Manually

Usage

Running the Server

Connecting with Claude Desktop

Available Tools

Example Queries

Technical Details

Dependencies

Architecture

Error Handling

Development

Running Tests

Contributing

Local Development

Troubleshooting

Common Issues

License

Acknowledgments

How to Use

Additional Information

Created

Company

Related MCP Servers

Alpaca MCP Server

Alpha Vantage MCP

Alphavantage

Start building your own MCP Server