CCXT MCP Server

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.

Instalación

1. Clona el repositorio (si aún no lo has hecho):
   git clone <your-repo-url> # Replace with your repository URL 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:

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

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).

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.