Servidor CCXT MCP

한국어 버전 (versión coreana)

El servidor CCXT MCP permite que los modelos de IA interactúen con las API de plataformas de intercambio de criptomonedas mediante el Protocolo de Contexto de Modelo (MCP) . Este servidor utiliza la biblioteca CCXT para brindar acceso a más de 100 plataformas de intercambio de criptomonedas y sus funciones de trading.

🚀 Inicio rápido

# Install the package globally
npm install -g @lazydino/ccxt-mcp

# Run with default settings
ccxt-mcp

# or run without installation
npx @lazydino/ccxt-mcp

Instalación y uso

Instalación global

# Install the package globally
npm install -g @lazydino/ccxt-mcp

Ejecutando con npx

Puedes ejecutarlo directamente sin instalación:

# Using default settings
npx @lazydino/ccxt-mcp

# Using custom configuration file
npx @lazydino/ccxt-mcp --config /path/to/config.json

Ver ayuda:

npx @lazydino/ccxt-mcp --help

Configuración

Registrar el servidor MCP en Claude Desktop

Abra la configuración del escritorio de Claude :
- Vaya al menú Configuración en la aplicación Claude Desktop
- Encuentra la sección "Servidores MCP"
Agregar un nuevo servidor MCP :
- Haga clic en el botón "Agregar servidor"
- Nombre del servidor: ccxt-mcp
- Comando: npx @lazydino/ccxt-mcp
- Argumentos adicionales (opcionales): --config /path/to/config.json
Guardar y probar el servidor :
- Guardar la configuración
- Pruebe la conexión con el botón "Probar conexión"

Métodos de configuración: dos opciones

Opción 1: Incluir información de la cuenta directamente en la configuración de escritorio de Claude (método básico)

Este método incluye información de la cuenta CCXT directamente en el archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ccxt-mcp": {
      "command": "npx",
      "args": ["-y", "@lazydino/ccxt-mcp"],
      "accounts": [
        {
          "name": "bybit_main",
          "exchangeId": "bybit",
          "apiKey": "YOUR_API_KEY",
          "secret": "YOUR_SECRET_KEY",
          "defaultType": "spot"
        },
        {
          "name": "bybit_futures",
          "exchangeId": "bybit",
          "apiKey": "YOUR_API_KEY",
          "secret": "YOUR_SECRET_KEY",
          "defaultType": "swap"
        }
      ]
    }
  }
}

Con este método, no necesita un archivo de configuración aparte. Todas las configuraciones se integran en el archivo de configuración de Claude Desktop.

Opción 2: Usar un archivo de configuración independiente (método avanzado)

Para separar la información de la cuenta en un archivo de configuración independiente, configúrelo de la siguiente manera:

Cree un archivo de configuración separado (por ejemplo, ccxt-accounts.json ):

{
  "accounts": [
    {
      "name": "bybit_main",
      "exchangeId": "bybit",
      "apiKey": "YOUR_API_KEY",
      "secret": "YOUR_SECRET_KEY",
      "defaultType": "spot"
    },
    {
      "name": "bybit_futures",
      "exchangeId": "bybit",
      "apiKey": "YOUR_API_KEY",
      "secret": "YOUR_SECRET_KEY",
      "defaultType": "swap"
    }
  ]
}

Especifique la ruta del archivo de configuración en la configuración de escritorio de Claude :

{
  "mcpServers": {
    "ccxt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@lazydino/ccxt-mcp",
        "--config",
        "/path/to/ccxt-accounts.json"
      ]
    }
  }
}

Razones para utilizar un archivo de configuración independiente :
Previene problemas de referencia recursiva
Separa información confidencial como claves API
Configuración multientorno más sencilla (desarrollo, pruebas, producción)
Control de versiones del archivo de configuración mejorado

Características principales

Recuperación de información del mercado :
- Intercambios de listas
- Ver información del mercado por bolsa
- Obtenga información de precios para símbolos específicos
- Ver información del libro de pedidos para símbolos específicos
- Buscar datos históricos de OHLCV
Funciones comerciales :
- Crear órdenes de mercado/límite
- Cancelar pedidos y consultar estado
- Ver saldos de cuentas
- Consultar el historial de operaciones
Análisis comercial :
- Análisis de rendimiento diario/semanal/mensual
- Cálculo de la tasa de victorias (últimos 7 días, 30 días, tiempo total)
- Relación promedio de ganancias/pérdidas (R-múltiplo)
- Análisis de series máximas de pérdidas/ganancias consecutivas
- Seguimiento de la variación de activos
- Métricas de rendimiento integrales
- Reconocimiento de patrones comerciales
- Cálculos de rentabilidad basados en períodos
Gestión de posiciones :
- Comercio de ratio de capital (por ejemplo, entrar con el 5% del capital de la cuenta)
- Configuración del apalancamiento del mercado de futuros (1-100x)
- Dimensionamiento dinámico de posiciones (basado en la volatilidad)
- Implementación de la estrategia de compra/venta dividida
Gestión de riesgos :
- Configuración de stop loss basada en indicadores técnicos (por ejemplo, el punto más bajo entre 10 velas en un gráfico de 5 minutos)
- Stop loss/take profit basado en volatilidad (múltiplos ATR)
- Límite máximo de pérdida permitido (diario/semanal)
- Configuración dinámica de toma de ganancias (ganancias de seguimiento)

Cómo funciona

User <--> AI Model(Claude/GPT) <--> MCP Protocol <--> CCXT MCP Server <--> Cryptocurrency Exchange API

Usuario : Solicitudes como "Dime el precio de Bitcoin" o "Compra Ethereum en mi cuenta de Binance".
Modelo de IA : comprende las solicitudes de los usuarios y determina qué herramientas/recursos de MCP utilizar
Protocolo MCP : Comunicación estandarizada entre la IA y el servidor MCP de CCXT
Servidor CCXT MCP : se comunica con las API de intercambio de criptomonedas mediante la biblioteca CCXT
API de intercambio : proporciona datos reales y ejecuta órdenes comerciales

Uso de modelos de IA

Al registrarse en Claude Desktop, podrá realizar los siguientes tipos de solicitudes a los modelos de IA:

Precauciones e indicaciones recomendadas

Al utilizar modelos de IA, tenga en cuenta las siguientes precauciones y utilice el siguiente mensaje para realizar operaciones comerciales efectivas:

Your goal is to execute trades using the ccxt tools as much as possible
Cautions:
- Accurately identify whether it's a futures market or spot market before proceeding with trades
- If there's no instruction about percentage of capital or amount to use, always calculate and execute trades using the entire available capital

Notas:

Los modelos de IA a veces confunden el comercio de futuros con el comercio al contado.
Sin una guía clara sobre el tamaño del capital comercial, la IA podría confundirse.
El uso del mensaje anterior ayuda a comunicar claramente sus intenciones comerciales.

Ejemplos de consultas básicas

Check and compare the current Bitcoin price on binance and coinbase.

Ejemplos de consultas comerciales avanzadas

Gestión de posiciones

Open a long position on BTC/USDT futures market in my Bybit account (bybit_futures) with 5% of capital using 10x leverage.
Enter based on moving average crossover strategy and set stop loss at the lowest point among the 12 most recent 5-minute candles.

Análisis de rendimiento

Analyze my Binance account (bybit_main) trading records for the last 7 days and show me the win rate, average profit, and maximum consecutive losses.

Análisis detallado de operaciones

Analyze my trading performance on the bybit_futures account for BTC/USDT over the last 30 days. Calculate win rate, profit factor, and identify any patterns in my winning trades.

Show me the monthly returns for my bybit_main account over the past 90 days and identify my best and worst trading months.

Analyze my consecutive wins and losses on my bybit_futures account and tell me if I have any psychological patterns affecting my trading after losses.

Desarrollo

Construyendo desde la fuente

# Clone repository
git clone https://github.com/lazy-dinosaur/ccxt-mcp.git

# Navigate to project directory
cd ccxt-mcp

# Install dependencies
npm install

# Build
npm run build

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia

Distribuido bajo la licencia MIT. Consulte el archivo de licencia para más información.

❤️ Apoyo

Si te resulta útil este proyecto, ¡considera darle un ⭐️ en GitHub!

CCXT MCP Server

Integrations