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
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!