Bybit MCP Server

Accede a la API v5 de Bybit para datos de mercado en tiempo real, operaciones de trading e información de la cuenta.

Documentación

Bybit MCP Server

⚠️ ADVERTENCIA DE TRADING ⚠️
Este servidor MCP puede ejecutar OPERACIONES DE TRADING REALES en Bybit cuando BYBIT_TRADING_ENABLED=true.
Las operaciones de trading utilizan DINERO REAL y pueden resultar en PÉRDIDAS FINANCIERAS.
Pruebe siempre primero en testnet (BYBIT_TESTNET=true) y comprenda los riesgos antes de habilitar el trading.
El trading está DESHABILITADO por defecto por seguridad.

Un servidor integral de Model Context Protocol (MCP) que proporciona acceso completo a la API v5 de Bybit. Este servidor permite a los asistentes de IA obtener datos de mercado en tiempo real, ejecutar operaciones de trading, gestionar posiciones y acceder a información de cuenta del exchange de criptomonedas Bybit.

🚀 Listo para Producción

✅ Totalmente Probado - Todos los endpoints probados y funcionando
✅ Soporte Docker - Imagen publicada disponible en falconiun/bybit-mcp
✅ Integración con VS Code - Configuraciones listas para usar proporcionadas
✅ Cobertura API Integral - Datos de mercado, trading, posiciones y gestión de cuenta

Características

Datos de Mercado Principales

Hora del Servidor: Obtener la hora actual del servidor de Bybit
Tickers: Recuperar información de tickers para símbolos de trading
Libro de Órdenes: Obtener profundidad del libro de órdenes para cualquier símbolo
Operaciones Recientes: Acceder al historial de operaciones recientes

Datos de Kline/Velas

Klines Estándar: Obtener datos de velas OHLCV
Klines de Precio de Marca: Obtener datos históricos del precio de marca
Klines de Precio de Índice: Obtener datos históricos del precio de índice
Klines de Índice Premium: Obtener datos del precio del índice premium

Información de Trading

Información de Instrumentos: Obtener información detallada de instrumentos de trading
Historial de Tasas de Financiamiento: Acceder a tasas de financiamiento históricas
Interés Abierto: Obtener estadísticas de interés abierto
Límites de Riesgo: Recuperar información de límites de riesgo

Estadísticas de Mercado

Fondo de Seguros: Obtener datos del fondo de seguros
Ratio Largo/Corto: Acceder a estadísticas del ratio largo/corto

Operaciones de Trading (Requiere `BYBIT_TRADING_ENABLED=true`)

Gestión de Órdenes: Colocar, modificar y cancelar órdenes con control total
Tipos de Órdenes Avanzados: Soporte para órdenes de Mercado, Límite y condicionales/disparadas
Operaciones por Lote: Ejecutar múltiples órdenes en una sola solicitud para mayor eficiencia
Historial de Órdenes: Ver historial completo de órdenes abiertas/cerradas y operaciones
Ejecución en Tiempo Real: Obtener retroalimentación inmediata sobre el estado de órdenes y ejecuciones
Órdenes Disparadas: Órdenes condicionales con disparadores de precio y lógica avanzada de stop/take profit

Gestión de Posiciones (Requiere `BYBIT_TRADING_ENABLED=true`)

Información de Posiciones: Consultar datos de posiciones en tiempo real con métricas detalladas
Control de Apalancamiento: Establecer y modificar el apalancamiento de posiciones dinámicamente
Gestión de Margen: Cambiar entre modos de margen cruzado/aislado
Stops de Trading: Establecer take profit, stop loss y trailing stops
Margen Automático: Configurar adición automática de margen
Modos de Posición: Cambiar entre modos de posición unidireccional y cobertura
Seguimiento de P&L: Acceder a registros de ganancias y pérdidas cerradas

Gestión de Cuenta y Billetera

Saldo de Billetera: Obtener información completa del saldo de la billetera
Saldo de Moneda Individual: Consultar saldos de monedas específicas
Información de Cuenta: Acceder a información y configuraciones detalladas de la cuenta
Múltiples Tipos de Cuenta: Soporte para cuentas UNIFIED, CONTRACT, SPOT, INVESTMENT

🎯 Capacidades Clave

✅ Cobertura API Completa

Datos de Mercado: Todos los endpoints de mercado v5 de Bybit (tickers, libro de órdenes, klines, tasas de financiamiento, etc.)
Trading: Gestión completa del ciclo de vida de órdenes (colocar, modificar, cancelar, operaciones por lote)
Órdenes Avanzadas: Órdenes condicionales/disparadas con estrategias sofisticadas de entrada y salida
Posiciones: Gestión completa de posiciones (apalancamiento, margen, stops, seguimiento de P&L)
Cuenta: Saldos de billetera, información de cuenta y soporte multi-cuenta

✅ Diseño Optimizado para Agentes

Descripciones Claras de Herramientas: Cada herramienta tiene descripciones detalladas y amigables para agentes que explican propósito y uso
Esquemas de Parámetros Enriquecidos: Esquemas JSON completos con ejemplos, enums y restricciones de validación
Advertencias de Seguridad: Las herramientas de trading importantes incluyen advertencias de seguridad y avisos de riesgo prominentes
Guía de Uso: Las herramientas incluyen contexto sobre cuándo y cómo usarlas efectivamente
Prevención de Errores: La validación de esquemas previene errores comunes de parámetros antes de las llamadas API

✅ Características de Producción

Seguridad Primero: Trading deshabilitado por defecto con habilitación explícita requerida
Soporte Testnet: Integración completa de testnet para desarrollo y pruebas seguras
Manejo de Errores: Manejo integral de errores con mensajes de error detallados
Validación de Datos: Los modelos Pydantic aseguran integridad de datos y seguridad de tipos
Listo para Docker: Imagen Docker publicada con manejo adecuado de variables de entorno

✅ Experiencia de Desarrollador

Integración con VS Code: Configuraciones listas para usar para despliegue local y Docker
Protocolo MCP: Cumplimiento completo del Model Context Protocol para integración con asistentes de IA
Seguridad de Tipos: Tipado completo estilo TypeScript con modelos Pydantic
Pruebas: Suite de pruebas integral con integración API real
Documentación: Documentación extensa con ejemplos y mejores prácticas

Categorías Soportadas

Lineal: Perpetuos USDT, perpetuos USDC, futuros USDC
Inverso: Perpetuos inversos, futuros inversos
Opción: Trading de opciones
Spot: Pares de trading spot

Instalación

Requisitos Previos

Python 3.13+
Gestor de paquetes uv

Usando uvx (Más Fácil - Sin Instalación Requerida)

Ejecute directamente desde PyPi sin clonar o instalar:

uvx bybit-mcp

Usando uv (Recomendado para Desarrollo Local)

Clone el repositorio:

git clone <repository-url>
cd bybit-mcp

Instale las dependencias:

uv sync

Configure las variables de entorno:

# Copy the example environment file
cp .env.example .env

# Edit .env with your Bybit API credentials
BYBIT_API_KEY=your_api_key_here
BYBIT_API_SECRET=your_api_secret_here
BYBIT_TESTNET=false  # Set to true for testnet
BYBIT_TRADING_ENABLED=false  # Set to true to enable trading operations

Ejecute el servidor:

uv run bybit-mcp

Uso de Docker

Construir y Ejecutar

# Build the Docker image
docker build -t bybit-mcp .

# Run with environment variables (correct syntax)
docker run -i --rm --init \
  -e BYBIT_API_KEY=your_api_key \
  -e BYBIT_API_SECRET=your_api_secret \
  -e BYBIT_TESTNET=false \
  -e BYBIT_TRADING_ENABLED=false \
  bybit-mcp

Usando Docker Compose

# Set environment variables in .env file first
docker-compose up

Usando la Imagen Publicada

# Use the published Docker image
docker run -i --rm --init \
  -e BYBIT_API_KEY=your_api_key \
  -e BYBIT_API_SECRET=your_api_secret \
  -e BYBIT_TESTNET=false \
  -e BYBIT_TRADING_ENABLED=false \
  falconiun/bybit-mcp

Configuración

Variables de Entorno

BYBIT_API_KEY: Su clave API de Bybit
BYBIT_API_SECRET: Su secreto API de Bybit
BYBIT_TESTNET: Establezca a true para usar el testnet de Bybit (por defecto es false)
BYBIT_TRADING_ENABLED: Establezca a true para habilitar operaciones de trading (por defecto es false)

Controles de Seguridad

El servidor implementa varios controles de seguridad para operaciones de trading:

Trading Deshabilitado por Defecto

Todas las herramientas de trading y gestión de posiciones están deshabilitadas por defecto
Debe establecer explícitamente BYBIT_TRADING_ENABLED=true para habilitar el trading
Las herramientas de datos de mercado están siempre disponibles independientemente de esta configuración

Soporte Testnet

Establezca BYBIT_TESTNET=true para usar el entorno testnet de Bybit
Recomendado para desarrollo y pruebas
El trading en testnet usa dinero ficticio y no afectará los saldos reales

Visibilidad de Herramientas

Las herramientas de trading solo aparecen en la lista de herramientas cuando BYBIT_TRADING_ENABLED=true
Las herramientas de gestión de posiciones requieren la misma bandera
Esto previene operaciones de trading accidentales

Permisos API

Asegúrese de que su clave API de Bybit tenga los permisos apropiados:

Solo lectura: Para datos de mercado (siempre seguro)
Trade: Requerido para operaciones de órdenes (habilite solo cuando sea necesario)
Posición: Requerido para gestión de posiciones
Retiro: No requerido para este servidor

Integración con Clientes MCP

Claude Desktop

Para usar el servidor MCP de Bybit con Claude Desktop, agregue la siguiente configuración a su archivo de configuración MCP de Claude Desktop:

Ubicación de la configuración MCP de Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Opción 1: Usando la Imagen Docker Publicada (Recomendado)

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "BYBIT_API_KEY=your_api_key_here",
        "-e", "BYBIT_API_SECRET=your_api_secret_here",
        "-e", "BYBIT_TESTNET=false",
        "-e", "BYBIT_TRADING_ENABLED=false",
        "falconiun/bybit-mcp"
      ]
    }
  }
}

Opción 2: Usando uvx (Sin Instalación Requerida)

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uvx",
      "args": [
        "bybit-mcp"
      ],
      "env": {
        "BYBIT_API_KEY": "your_api_key_here",
        "BYBIT_API_SECRET": "your_api_secret_here",
        "BYBIT_TESTNET": "false",
        "BYBIT_TRADING_ENABLED": "false"
      }
    }
  }
}

Opción 3: Desarrollo Local

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uv",
      "args": ["run", "bybit-mcp"],
      "cwd": "path/to/your/bybit-mcp",
      "env": {
        "BYBIT_API_KEY": "your_api_key_here",
        "BYBIT_API_SECRET": "your_api_secret_here",
        "BYBIT_TESTNET": "false",
        "BYBIT_TRADING_ENABLED": "false"
      }
    }
  }
}

Notas Importantes de Claude Desktop:

Reemplace your_api_key_here y your_api_secret_here con sus credenciales API reales de Bybit
Establezca BYBIT_TESTNET=true para probar con dinero ficticio (recomendado para el primer uso)
Establezca BYBIT_TRADING_ENABLED=true solo cuando quiera habilitar operaciones de trading reales
Reinicie Claude Desktop después de modificar el archivo de configuración

Ejemplos de Uso con Claude Desktop:

Una vez configurado, puede hacer preguntas a Claude Desktop como:

"¿Cuál es mi saldo de USDT?"
"¿Cuál es el precio actual de BTCUSDT?"
"Muéstrame el libro de órdenes para ETHUSDT"
"Obtén el historial de trading reciente de mi cuenta"
"¿Qué posiciones tengo abiertas actualmente?"

Para trading (cuando BYBIT_TRADING_ENABLED=true):

"Coloca una orden límite de compra de 0.001 BTC a $95,000"
"Cancela todas mis órdenes abiertas"
"Establece apalancamiento de 10x para BTCUSDT"
"Establece un stop loss en $90,000 para mi posición de BTC"

Mejores Prácticas de Seguridad:

Comience con BYBIT_TESTNET=true para probar la funcionalidad de manera segura
Use claves API con permisos mínimos requeridos (solo lectura para datos de mercado, permisos de trading solo cuando sea necesario)
Nunca comparta su archivo de configuración que contenga claves API
Considere usar variables de entorno para credenciales sensibles en producción

Otros Clientes MCP

Este servidor funciona con cualquier cliente compatible con MCP. El formato de configuración puede variar ligeramente entre clientes, pero la configuración principal sigue siendo la misma:

Integración MCP con VS Code

Opción 1: Desarrollo Local (Recomendado)

Agregue a su settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "bybit-mcp": {
        "type": "stdio",
        "command": "uvx",
        "args": ["bybit-mcp"],
        "env": {
          "BYBIT_API_KEY": "${input:bybit_api_key}",
          "BYBIT_API_SECRET": "${input:bybit_api_secret}",
          "BYBIT_TESTNET": "${input:bybit_testnet}",
          "BYBIT_TRADING_ENABLED": "${input:bybit_trading_enabled}"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "bybit_api_key",
        "description": "Bybit API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_api_secret",
        "description": "Bybit API Secret",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_testnet",
        "description": "Use Bybit Testnet",
        "default": "false"
      },
      {
        "type": "promptString",
        "id": "bybit_trading_enabled",
        "description": "Enable Bybit Trading",
        "default": "false"
      }
    ]
  }
}

Opción 2: Docker (Producción)

Para usar la imagen Docker publicada:

{
  "mcp": {
    "servers": {
      "bybit-mcp": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--init",
          "-e",
          "DOCKER_CONTAINER",
          "-e",
          "BYBIT_API_KEY",
          "-e",
          "BYBIT_API_SECRET",
          "-e",
          "BYBIT_TRADING_ENABLED",
          "-e",
          "BYBIT_TESTNET",
          "falconiun/bybit-mcp"
        ],
        "env": {
          "DOCKER_CONTAINER": "true",
          "BYBIT_API_KEY": "${input:bybit_api_key}",
          "BYBIT_API_SECRET": "${input:bybit_api_secret}",
          "BYBIT_TRADING_ENABLED": "${input:bybit_trading_enabled}",
          "BYBIT_TESTNET": "${input:bybit_testnet}"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "bybit_api_key",
        "description": "Bybit API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_api_secret",
        "description": "Bybit API Secret",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_testnet",
        "description": "Use Bybit Testnet",
        "default": "false"
      },
      {
        "type": "promptString",
        "id": "bybit_trading_enabled",
        "description": "Enable Bybit Trading",
        "default": "false"
      }
    ]
  }
}

Notas Importantes de Docker:

Las banderas -e son requeridas para pasar variables de entorno al contenedor Docker
La sección env establece las variables en el entorno de VS Code, que luego se pasan a Docker
La bandera --init ayuda con el manejo adecuado de señales en contenedores

Pruebas

Inspector MCP

Pruebe el servidor usando el inspector MCP:

npx @modelcontextprotocol/inspector uv run bybit-mcp

Pruebas Unitarias

uv run pytest tests/

Referencia API

Herramientas de Datos de Mercado

Todas las herramientas de datos de mercado están siempre disponibles y no requieren permisos especiales.

Datos Principales

get_server_time: Obtener la hora actual del servidor de Bybit
get_tickers: Obtener información de tickers para símbolos
get_order_book: Obtener profundidad del libro de órdenes
get_recent_trades: Obtener historial de operaciones recientes

Datos de Kline/Velas

get_kline: Obtener datos de kline OHLCV estándar
get_mark_price_kline: Obtener datos históricos del precio de marca
get_index_price_kline: Obtener datos históricos del precio de índice
get_premium_index_price_kline: Obtener datos de kline del índice premium

Información de Mercado

get_instruments_info: Obtener detalles de instrumentos de trading
get_funding_rate_history: Obtener historial de tasas de financiamiento
get_open_interest: Obtener estadísticas de interés abierto
get_insurance: Obtener datos del fondo de seguros
get_risk_limit: Obtener información de límites de riesgo
get_long_short_ratio: Obtener datos del ratio largo/corto

Herramientas de Trading (Requiere `BYBIT_TRADING_ENABLED=true`)

Estas herramientas solo están disponibles cuando el trading está habilitado mediante la variable de entorno BYBIT_TRADING_ENABLED.

Gestión de Órdenes

place_order: Colocar órdenes estándar (Mercado, Límite) para ejecución inmediata o a precio especificado
place_trigger_order: Colocar órdenes condicionales/disparadas con estrategias avanzadas de stop-loss, take-profit y entrada de mercado
amend_order: Modificar órdenes pendientes existentes (precio, cantidad o condiciones de disparo)
cancel_order: Cancelar una orden pendiente específica
cancel_all_orders: Cancelar todas las órdenes abiertas para una mejor gestión de riesgos

Operaciones por Lote

batch_place_order: Colocar múltiples órdenes en una sola solicitud
batch_amend_order: Modificar múltiples órdenes en una sola solicitud
batch_cancel_order: Cancelar múltiples órdenes en una sola solicitud

Información de Órdenes

get_open_closed_orders: Obtener órdenes abiertas y cerradas
get_order_history: Obtener historial de órdenes
get_trade_history: Obtener historial de ejecución de operaciones

Gestión de Billetera y Cuenta

get_wallet_balance: Obtener información completa del saldo de la billetera
get_single_coin_balance: Obtener saldo para una criptomoneda específica
get_account_info: Obtener información y configuraciones detalladas de la cuenta

Herramientas de Posición (Requiere `BYBIT_TRADING_ENABLED=true`)

Las herramientas de gestión de posiciones requieren que el trading esté habilitado.

Información de Posición

get_position_info: Consultar datos de posición en tiempo real
get_closed_pnl: Obtener registros de ganancias y pérdidas cerradas

Configuración de Posición

set_leverage: Establecer apalancamiento de posición
switch_cross_isolated_margin: Cambiar modo de margen
switch_position_mode: Cambiar entre modo unidireccional/cobertura
set_auto_add_margin: Configurar adición automática de margen

Gestión de Riesgos

set_trading_stop: Establecer take profit, stop loss y trailing stops
modify_position_margin: Añadir o reducir margen de posición

Herramientas

Todas las herramientas admiten los siguientes parámetros comunes cuando corresponda:

category: Tipo de producto (linear, inverse, option, spot)
symbol: Símbolo de trading (p. ej., BTCUSDT)
limit: Límite de tamaño de datos por página
start/end: Rango de tiempo para datos históricos

Ejemplos de Llamadas a Herramientas

Obtener Hora del Servidor

{
  "name": "get_server_time",
  "arguments": {}
}

Obtener Datos de Ticker

{
  "name": "get_tickers",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT"
  }
}

Obtener Datos de Kline

{
  "name": "get_kline",
  "arguments": {
    "symbol": "BTCUSDT",
    "interval": "1",
    "category": "linear",
    "limit": 100
  }
}

Colocar Orden (Requiere Trading Habilitado)

{
  "name": "place_order",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Limit",
    "qty": "0.001",
    "price": "50000.00",
    "orderLinkId": "my-order-123"
  }
}

Colocar Orden de Activación (Requiere Trading Habilitado)

{
  "name": "place_trigger_order",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Market",
    "qty": "0.001",
    "triggerPrice": "48000.00",
    "triggerDirection": 2,
    "triggerBy": "LastPrice",
    "orderLinkId": "trigger-buy-123"
  }
}

Obtener Información de Posición (Requiere Trading Habilitado)

{
  "name": "get_position_info",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT"
  }
}

Establecer Apalancamiento (Requiere Trading Habilitado)

{
  "name": "set_leverage",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "buyLeverage": "10",
    "sellLeverage": "10"
  }
}

Establecer Stop de Trading (Requiere Trading Habilitado)

{
  "name": "set_trading_stop",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "takeProfit": "55000.00",
    "stopLoss": "45000.00",
    "positionIdx": 0
  }
}

Obtener Saldo de Wallet

{
  "name": "get_wallet_balance",
  "arguments": {
    "accountType": "UNIFIED",
    "coin": "USDT"
  }
}

Obtener Saldo de Moneda Individual

{
  "name": "get_single_coin_balance",
  "arguments": {
    "accountType": "UNIFIED",
    "coin": "BTC"
  }
}

Obtener Información de Cuenta

{
  "name": "get_account_info",
  "arguments": {}
}

Recursos

bybit://market/info: Información general sobre los endpoints y capacidades disponibles

Solución de Problemas

Problemas Comunes

Variables de Entorno que No Funcionan en Docker

Problema: Las claves API no se están pasando al contenedor Docker
Solución: Use el formato de bandera -e que se muestra en la configuración de Docker anterior
Nota: La sección env en la configuración de MCP de VS Code establece variables en el entorno de VS Code, que luego se pasan a Docker mediante banderas -e

Errores de Validación de Pydantic

Problema: Discrepancias de tipos de datos (p. ej., enteros vs cadenas)
Solución: El servidor incluye conversión automática de tipos para inconsistencias comunes de la API
Ejemplo: El campo seq en el historial de operaciones se convierte automáticamente de int a string

Operaciones de Trading Deshabilitadas

Problema: Las herramientas de trading no aparecen o devuelven errores de deshabilitación
Solución: Establezca BYBIT_TRADING_ENABLED=true en sus variables de entorno
Seguridad: Esto es intencional: el trading está deshabilitado por defecto por seguridad

Errores de Permisos de API

Problema: 401 No autorizado o permisos insuficientes
Solución: Verifique que su clave API de Bybit tenga los permisos requeridos:
- Solo lectura: Para datos de mercado (siempre seguro)
- Trading: Requerido para operaciones de órdenes
- Posición: Requerido para la gestión de posiciones

Modo de Depuración

Habilite el registro de depuración estableciendo el nivel de registro:

# Local development
PYTHONPATH=src python -c "import logging; logging.basicConfig(level=logging.DEBUG)" -m bybit_mcp.main

# Docker
docker run -e PYTHONPATH=src -e LOG_LEVEL=DEBUG ...

Desarrollo

Estructura del Proyecto

bybit-mcp/
├── src/bybit_mcp/
│   ├── __init__.py
│   ├── main.py              # MCP server implementation
│   ├── market.py            # Market data API functions
│   ├── trade.py             # Trading API functions
│   ├── position.py          # Position management functions
│   └── models/
│       ├── market_models.py # Market data Pydantic models
│       ├── trade_models.py  # Trading Pydantic models
│       └── position_models.py # Position Pydantic models
├── tests/
│   ├── test_market.py       # Market data unit tests
│   └── test_trade.py        # Trading unit tests
├── pyproject.toml           # Project configuration
├── Dockerfile               # Docker configuration
└── README.md

Contribuciones

Haga un fork del repositorio
Cree una rama de características
Realice sus cambios
Añada pruebas para la nueva funcionalidad
Ejecute el conjunto de pruebas
Envíe una solicitud de extracción (pull request)

Calidad del Código

El proyecto utiliza:

Ruff: Para linting y formato
Pytest: Para pruebas
Pydantic: Para validación de datos
Type hints: Para una mejor documentación del código

Actualizaciones Recientes

v0.1.0 - Versión de Producción

✅ Cobertura completa de la API Bybit v5 (datos de mercado, trading, posiciones, cuentas)
✅ Imagen Docker publicada en falconiun/bybit-mcp
✅ Corregidos problemas de validación de Pydantic (conversión de tipo del campo seq)
✅ Integración completa de MCP con VS Code con configuración Docker funcional
✅ Manejo de errores mejorado y controles de seguridad
✅ Soporte completo de gestión de wallet y cuenta
✅ Soporte de testnet para desarrollo seguro
✅ Listo para producción con pruebas exhaustivas

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulte el archivo LICENSE para más detalles.

Descargo de Responsabilidad

Este software es para fines educativos y de desarrollo. Siempre pruebe a fondo antes de usarlo en entornos de producción. Los autores no son responsables de ninguna pérdida financiera incurrida por el uso de este software.

Soporte

Para problemas y preguntas:

Consulte los GitHub Issues existentes
Cree un nuevo issue con información detallada
Proporcione registros y mensajes de error cuando corresponda

Apoye el Proyecto

Si encuentra útil este servidor MCP para sus necesidades de trading y desarrollo, considere apoyar su desarrollo continuo:

Su apoyo ayuda a mantener y mejorar este proyecto, añadir nuevas funciones y garantizar la compatibilidad con las últimas actualizaciones de la API de Bybit. ¡Gracias por considerar una contribución!

Agradecimientos

Construido con el Model Context Protocol
Utiliza la Bybit API v5
Impulsado por la biblioteca pybit

Bybit MCP Server

Documentación

Bybit MCP Server

🚀 Listo para Producción

Características

Datos de Mercado Principales

Datos de Kline/Velas

Información de Trading

Estadísticas de Mercado

Operaciones de Trading (Requiere BYBIT_TRADING_ENABLED=true)

Gestión de Posiciones (Requiere BYBIT_TRADING_ENABLED=true)

Gestión de Cuenta y Billetera

🎯 Capacidades Clave

✅ Cobertura API Completa

✅ Diseño Optimizado para Agentes

✅ Características de Producción

✅ Experiencia de Desarrollador

Categorías Soportadas

Instalación

Requisitos Previos

Usando uvx (Más Fácil - Sin Instalación Requerida)

Usando uv (Recomendado para Desarrollo Local)

Uso de Docker

Construir y Ejecutar

Usando Docker Compose

Usando la Imagen Publicada

Configuración

Variables de Entorno

Controles de Seguridad

Trading Deshabilitado por Defecto

Soporte Testnet

Visibilidad de Herramientas

Permisos API

Integración con Clientes MCP

Claude Desktop

Otros Clientes MCP

Integración MCP con VS Code

Opción 1: Desarrollo Local (Recomendado)

Opción 2: Docker (Producción)

Pruebas

Inspector MCP

Pruebas Unitarias

Referencia API

Herramientas de Datos de Mercado

Datos Principales

Datos de Kline/Velas

Información de Mercado

Herramientas de Trading (Requiere BYBIT_TRADING_ENABLED=true)

Gestión de Órdenes

Operaciones por Lote

Información de Órdenes

Gestión de Billetera y Cuenta

Herramientas de Posición (Requiere BYBIT_TRADING_ENABLED=true)

Información de Posición

Configuración de Posición

Gestión de Riesgos

Herramientas

Ejemplos de Llamadas a Herramientas

Recursos

Solución de Problemas

Problemas Comunes

Variables de Entorno que No Funcionan en Docker

Errores de Validación de Pydantic

Operaciones de Trading Deshabilitadas

Errores de Permisos de API

Modo de Depuración

Desarrollo

Estructura del Proyecto

Contribuciones

Calidad del Código

Actualizaciones Recientes

Licencia

Descargo de Responsabilidad

Soporte

Apoye el Proyecto

Agradecimientos

Operaciones de Trading (Requiere `BYBIT_TRADING_ENABLED=true`)

Gestión de Posiciones (Requiere `BYBIT_TRADING_ENABLED=true`)

Herramientas de Trading (Requiere `BYBIT_TRADING_ENABLED=true`)

Herramientas de Posición (Requiere `BYBIT_TRADING_ENABLED=true`)