MCP Bybit API Interface

Una interfaz para interactuar con la API del exchange de criptomonedas Bybit.

GitHub
9
Prueba este MCPPatrocinado

Documentación

Interfaz de API MCP Bybit

smithery badge Buy Me A Coffee

Servidor MCP (Protocolo de Contexto de Modelo) de Bybit. Proporciona una interfaz conveniente para interactuar con la API V5 de Bybit mediante herramientas MCP. Permite obtener datos de mercado, gestionar información de cuenta y realizar/ cancelar órdenes a través de llamadas API envueltas como herramientas.

Bybit Server MCP server

⚠️ Seguridad y Protección

Este servidor puede realizar operaciones reales con dinero real. Lea esto antes de configurarlo:

  • El trading está deshabilitado por defecto. Las herramientas de mutación (place_order, cancel_order, amend_order, cancel_all_orders, set_trading_stop, set_margin_mode, set_leverage) devuelven un error a menos que establezca explícitamente TRADING_ENABLED=true.
  • Use primero la testnet. Establezca TESTNET=true mientras experimenta. Combínelo con TRADING_ENABLED=false para una configuración completamente de solo lectura, o establezca READONLY_MODE=true para bloquear estrictamente toda herramienta de mutación independientemente de otras configuraciones.
  • El tamaño de la orden está limitado. MAX_ORDER_SIZE_USDT (por defecto 100) limita el valor nocional estimado de una orden para protegerse contra operaciones grandes accidentales.
  • Las claves API nunca se registran ni se exponen. Ninguna herramienta devuelve sus claves; los registros solo informan si una clave está presente.
  • Nunca comprometa sus claves API. Proporciónelas únicamente a través de variables de entorno.

Instalación

Requiere Python 3.12+. Este proyecto utiliza uv.

git clone https://github.com/dlwjdtn535/mcp-bybit-server.git
cd mcp-bybit-server
uv sync
uv run mcp-bybit-server   # runs the MCP server over stdio

Después de la instalación, el comando mcp-bybit-server es el punto de entrada utilizado por las configuraciones del cliente MCP a continuación.

Instalación mediante Smithery

Para instalar automáticamente este servidor de Interfaz de API Bybit para Claude Desktop a través de Smithery:

npx -y @smithery/cli install @dlwjdtn535/mcp-bybit-server --client claude

Configuración (Claude Desktop, Cline, Roo Code, etc.)

Agregue una de las siguientes opciones a su archivo de configuración MCP (por ejemplo, claude_desktop_config.json / mcp_settings.json).

Usando uv (ejecutar desde un repositorio clonado):

{
  "mcpServers": {
    "bybit": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-bybit-server",
        "mcp-bybit-server"
      ],
      "env": {
        "ACCESS_KEY": "YOUR_BYBIT_API_KEY",
        "SECRET_KEY": "YOUR_BYBIT_SECRET_KEY",
        "TESTNET": "true",
        "TRADING_ENABLED": "false"
      }
    }
  }
}

En Windows, use una ruta absoluta con dobles barras invertidas (por ejemplo, C:\\Users\\YOUR_USERNAME\\mcp-bybit-server).

Usando Docker:

Primero extraiga la imagen: docker pull dlwjdtn535/mcp-bybit-server:latest

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "ACCESS_KEY=YOUR_BYBIT_API_KEY",
        "-e", "SECRET_KEY=YOUR_BYBIT_SECRET_KEY",
        "-e", "TESTNET=true",
        "-e", "TRADING_ENABLED=false",
        "-e", "MAX_ORDER_SIZE_USDT=100",
        "dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

Nota: Use siempre @latest o una etiqueta de versión específica tanto para NPX como para Docker para asegurarse de usar la versión prevista.

Variables de Entorno

VariableRequeridaPredeterminadoDescripción
ACCESS_KEYSí–Clave API de Bybit.
SECRET_KEYSí–Secreto API de Bybit.
MEMBER_IDNo–ID de miembro de Bybit (opcional).
TESTNETNofalseUse la testnet de Bybit cuando true.
TRADING_ENABLEDNofalseDebe ser true para permitir cualquier herramienta de mutación/trading.
READONLY_MODENofalseCuando true, bloquea toda herramienta de mutación (tiene prioridad sobre TRADING_ENABLED).
MAX_ORDER_SIZE_USDTNo100Limita el valor nocional estimado (USDT) de una sola orden.
RESPONSE_VERBOSITYNonormalminimal recorta las respuestas de get_tickers/get_positions a campos esenciales para ahorrar tokens; normal/full devuelven la carga útil completa.

Herramientas 🛠️

Datos de mercado

  • get_orderbook — libro de órdenes (category, symbol, limit?).
  • get_kline — velas (category, symbol, interval, start?, end?, limit?).
  • get_tickers — información de ticker (category, symbol).
  • get_public_trade_history — operaciones públicas recientes (category, symbol, limit?).
  • get_instruments_info — metadatos/límites del instrumento (category, symbol, status?, baseCoin?).
  • get_funding_rate_history — historial de tasas de financiación para perpetuos (category, symbol, startTime?, endTime?, limit?).
  • get_open_interest — interés abierto a lo largo del tiempo (category, symbol, intervalTime?, ...).
  • get_fee_rate — tasas de comisión maker/taker (category, symbol?, baseCoin?).
  • get_server_time — hora del servidor de Bybit.
  • market_snapshot — vista de mercado compuesta (libro de órdenes + ticker + kline + instrumento + operaciones recientes, además de tasa de financiación e interés abierto para futuros) en una sola llamada.

Cuenta

  • get_wallet_balance — saldos (accountType, coin?).
  • get_positions — posiciones abiertas (category, symbol?).
  • get_order_history — órdenes históricas.
  • get_open_orders — órdenes abiertas actuales.
  • get_api_key_information — detalles de la clave API.

Trading (mutación — requiere TRADING_ENABLED=true)

  • validate_order — validación previa al vuelo; nunca coloca una orden. No está bloqueado por los indicadores de trading.
  • place_order — colocar una orden; admite dry_run=true para validar sin colocar.
  • amend_order — modificar una orden existente en su lugar.
  • cancel_order — cancelar una sola orden.
  • cancel_all_orders — cancelar todas las órdenes abiertas (opcionalmente con alcance).
  • set_trading_stop — establecer take profit / stop loss / trailing stop.
  • set_margin_mode — establecer margen aislado/cruzado.
  • set_leverage — establecer apalancamiento para un símbolo de futuros.

(Consulte las cadenas de documentación de las funciones en el código para descripciones detalladas de parámetros y ejemplos.)

Configuración de Clave API

Para usar esta interfaz de API de Bybit, cree una clave API desde Bybit:

  1. Inicie sesión en su cuenta de Bybit.
  2. Navegue a Gestión de API.
  3. Cree una nueva clave API.
  4. Configuraciones de seguridad importantes:
    • Habilite la restricción de IP si es posible, y agregue SOLO la(s) dirección(es) IP desde las que se ejecuta el servidor.
    • Nunca comparta sus claves API ni las exponga en repositorios públicos.
    • Permisos recomendados:
      • Lectura (requerido)
      • Trading (requerido solo si habilita la ejecución de órdenes)
      • Billetera (requerido para verificar saldos)

Desarrollo

uv sync --group dev   # install dev dependencies (pytest, ruff)
uv run ruff check .   # lint
uv run pytest -q      # run the unit test suite (no live API calls)

CI (GitHub Actions) ejecuta lint + pruebas en cada push/PR; las imágenes Docker se compilan y publican automáticamente en los pushes a main.

Patrocinio y Donaciones

Si encuentra útil este proyecto y desea apoyar su desarrollo:

Cómprame un Café

"Buy Me A Coffee"

Programa de Referidos

También puede apoyar este proyecto registrándose en Bybit usando nuestro enlace de referido:

Su apoyo ayuda a mantener y mejorar este proyecto. ¡Gracias! 🙏

Contacto y Soporte

Para consultas adicionales o soporte, contacte:

¡Damos la bienvenida a sus preguntas y comentarios!

Licencia

Licencia MIT