CCXT MCP Server

by pcriadoperez

321 downloads
Not rated
GitHub

About

CCXT MCP Server is a Model Context Protocol (MCP) server that provides trading functionality through the CCXT library, enabling AI assistants to interact with crypto exchanges. It supports any exchange that CCXT supports and is designed for developers building automated trading…

Details

Author
pcriadoperez
Downloads
321
Categories
Other

- Fetch ticker data for any symbol
- Get order book data and recent trades
- Create and cancel orders (market, limit, etc.)
- Fetch account balance
- Trading analysis and order management prompts
- Testnet support for safe development

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name CCXT MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install the MCP server with mcp install run.py, then configure environment variables for exchange API keys in your MCP client settings (e.g., Claude Desktop). For development, run mcp dev run.py after setting up dependencies with uv pip install -e ..

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ccxt mcp server": {
            "ccxt-mcp-pcriadoperez": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "ccxt-mcp-pcriadoperez": {
        "command": "uv",
        "args": [
            "pip",
            "install",
            "-e",
            "."
        ]
    }
}

CCXT MCP Server

A Model Context Protocol (MCP) server that provides trading functionality through the CCXT library.

ScreenRecording2025-04-19at17 22 45-ezgif com-speed

cursor

Features

- Fetch ticker data for any symbol
- Get order book data
- View recent trades
- Create orders (market, limit, etc.)
- Cancel orders
- Fetch account balance
- Trading analysis prompts
- Order management guidance
- Testnet support
- Supports any exchange that CCXT supports
- Cached exchange instances for better performance

Project Structure

src/ccxt_mcp/
├── __init__.py              # Main server file
├── utils/
│   └── exchange.py          # Exchange management with testnet support
├── tools/
│   ├── fetch_ticker.py      # Ticker data tool
│   ├── fetch_order_book.py  # Order book tool
│   ├── fetch_trades.py      # Trades tool
│   ├── create_order.py      # Order creation tool
│   ├── cancel_order.py      # Order cancellation tool
│   └── fetch_balance.py     # Balance fetching tool
└── prompts/
    ├── trading_analysis.py  # Trading analysis prompt
    ├── order_management.py  # Order management prompt
    └── testnet_guidance.py  # Testnet guidance prompt

Setup to run MCP server

Prerequisites:

These are instructions for Claude Desktop but this mcp server could be used for any MCP Client.

1. Download github repo:

git clone https://github.com/pcriadoperez/ccxt-mcp.git

2. Enter folder
cd ccxt-mcp

3. Install mcp server
mcp install run.py

4. Open Claude desktop -> Settings -> Developer -> Edit config
- Add your env variables
- You may have Replace in command you uv location (You can find it running which uv)
- It should look like the below config

{
  "mcpServers": {
    "CCXT Trading Server": {
      "command": "/Users/pablo/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "ccxt",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/pablo/github/ccxt-mcp-2/run.py"
      ],
      "env":{
          "BINANCE_APIKEY": "BINANCE_APIKEY",
          "BINANCE_SECRET": "BINANCE_SECRET"
      }
    }
  }
}

5. Close and open claude

Setup for contributing

1. Clone the repository:

git clone https://github.com/pcriadoperez/ccxt-mcp.git
cd ccxt-mcp

2. Install dependencies:

uv pip install -e .

3. Set up environment variables:
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.