Servidor CCXT MCP

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) que expone varias funciones de la biblioteca CCXT como herramientas para modelos de lenguaje grandes (LLM).

Permite a los LLM interactuar con los intercambios de criptomonedas para tareas como obtener saldos, datos de mercado, crear órdenes y más, de forma estandarizada y asincrónica.

Este servidor está construido utilizando FastMCP , lo que simplifica el proceso de creación de servidores MCP en Python.

Características

• Integración CCXT : incluye funciones comunes de CCXT para la interacción de intercambio.

• Asíncrono : creado con asyncio y ccxt.async_support para operaciones eficientes sin bloqueos.

• Definiciones de herramientas claras : utiliza typing.Annotated y pydantic.Field para descripciones y restricciones de parámetros claras, lo que hace que sea más fácil para los LLM (y desarrolladores) comprender y usar las herramientas.

• Manejo de autenticación : admite autenticación mediante clave API, secreto y frase de contraseña para puntos finales privados.

• Herramientas públicas y privadas : proporciona herramientas separadas para datos de mercado público y acciones de cuentas privadas.

Related MCP server: CCXT MCP Server

Instalación

1. Clona el repositorio (si aún no lo has hecho):

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

2. Crear y activar un entorno virtual (recomendado):

   python -m venv .venv
   source .venv/bin/activate # On Windows use `.venv\Scripts\activate`

3. Instalar dependencias: Las bibliotecas necesarias se listan en requirements.txt . Puedes instalarlas usando pip o uv .

   • Usando pip :

     pip install -r requirements.txt

   • Usando uv (si está instalado):

     uv pip install -r requirements.txt
     # Or, if you prefer uv's environment management:
     # uv sync

Ejecución del servidor

Una vez instaladas las dependencias, puedes ejecutar el servidor MCP directamente:

uv run mcp_server.py

Debería ver un resultado que indique que el servidor se ha iniciado, similar a lo siguiente:

Starting CCXT MCP Server (Async with Annotated Params and Tool Metadata)...
# ... (FastMCP server startup logs)

Luego, el servidor estará disponible para que los clientes de MCP se conecten (normalmente en un puerto predeterminado administrado por FastMCP, a menos que se configure de otro modo).

Configuración del servidor MCP (para clientes MCP)

Si está utilizando un cliente MCP que requiere una configuración manual del servidor (como la aplicación de escritorio Claude), deberá proporcionar una configuración similar al siguiente JSON.

Cree un archivo claude_desktop_config.json (o el equivalente para su cliente MCP) con la siguiente estructura:

{
  "mcpServers": {
        "ccxt-mcp-server": {
            "command": "uv",
            "args": [
              "--directory",
              "/path/to/your/ccxt-mcp-server",
              "run",
              "mcp_server.py"
            ]
        }
    }
}

Importante:

• Reemplace "/path/to/your/ccxt-mcp-server" con la ruta absoluta real al directorio donde clonó o descargó este proyecto ccxt-mcp-server (es decir, el directorio que contiene mcp_server.py ).

• El "command" y "args" dependerán de cómo ejecutes los proyectos de Python y de si usas uv o un entorno virtual. El ejemplo anterior usa uv .

  • Si está utilizando un entorno virtual directamente con python , el comando podría verse así:

    {
      "mcpServers": {
            "ccxt-mcp-server": {
                "command": "/path/to/your/.venv/bin/python", // Or `python.exe` on Windows
                "args": [
                  "mcp_server.py"
                ],
                "workingDirectory": "/path/to/your/ccxt-mcp-server"
            }
        }
    }

    Asegúrese de que el command apunte al ejecutable de Python dentro de su entorno virtual y que workingDirectory esté configurado en la raíz del proyecto.

Esta configuración le dice a su cliente MCP cómo iniciar y comunicarse con el servidor MCP de CCXT.

Herramientas MCP disponibles

Este servidor expone las siguientes herramientas, categorizadas según si requieren autenticación API.

Herramientas que requieren autenticación de API (privadas)

• fetch_account_balance : obtiene el saldo de la cuenta actual.

• fetch_deposit_address : obtiene la dirección de depósito para una moneda.

• withdraw_cryptocurrency : retira criptomonedas a una dirección específica.

• fetch_open_positions : recupera posiciones abiertas (principalmente para futuros/derivados).

• set_trading_leverage : establece el apalancamiento para un símbolo comercial (principalmente para futuros).

• create_spot_limit_order : coloca una nueva orden de límite spot.

• create_spot_market_order : coloca una nueva orden en el mercado al contado.

• create_futures_limit_order : coloca una nueva orden límite de futuros.

• create_futures_market_order : coloca una nueva orden en el mercado de futuros.

• cancel_order : cancela una orden abierta existente.

• fetch_order_history : obtiene el historial de pedidos (abiertos/cerrados).

• fetch_my_trade_history : obtiene el historial de operaciones ejecutadas por el usuario.

Herramientas para datos públicos (no se requiere autenticación)

• fetch_ohlcv : obtiene datos históricos de OHLCV (velas).

• fetch_funding_rate : obtiene la tasa de financiación para un contrato de futuros perpetuos.

• fetch_long_short_ratio : obtiene la relación larga/corta (requiere params específicos del intercambio).

• fetch_option_contract_data : obtiene datos de mercado para un contrato de opciones.

• fetch_market_ticker : obtiene los últimos datos del indicador de precios de un símbolo.

• fetch_public_market_trades : obtiene transacciones públicas recientes de un símbolo.

Cada herramienta tiene descripciones detalladas de parámetros disponibles a través del propio protocolo MCP, gracias al uso de Annotated y pydantic.Field .

Notas de uso

• Futuros/Opciones : al utilizar herramientas relacionadas con futuros u opciones (por ejemplo, fetch_open_positions , create_futures_limit_order , fetch_funding_rate ), asegúrese de configurar correctamente el cliente CCXT a través del argumento params , pasando específicamente {'options': {'defaultType': 'future'}} (o 'swap' , 'option' según sea necesario) si el intercambio lo requiere o no tiene como valor predeterminado el tipo de mercado deseado.

• fetch_long_short_ratio : Este no es un método unificado estándar de CCXT. Debe proporcionar el nombre del método de intercambio específico y sus parámetros dentro del argumento params (p. ej., params={'method_name': 'fapiPublicGetGlobalLongShortAccountRatio', 'method_params': {'symbol': 'BTCUSDT', 'period': '5m'}} para futuros de Binance).

• Manejo de errores : las herramientas devuelven un diccionario con una clave "error" si ocurre un problema durante la llamada CCXT.