Bybit MCP Server

Acesse a API v5 da Bybit para dados de mercado em tempo real, operações de negociação e informações da conta.

Documentação

Bybit MCP Server

⚠️ AVISO DE NEGOCIAÇÃO ⚠️
Este servidor MCP pode executar OPERAÇÕES REAIS DE NEGOCIAÇÃO na Bybit quando BYBIT_TRADING_ENABLED=true.
As operações de negociação usam DINHEIRO REAL e podem resultar em PERDAS FINANCEIRAS.
Sempre teste primeiro na testnet (BYBIT_TESTNET=true) e entenda os riscos antes de habilitar a negociação.
A negociação está DESATIVADA por padrão por segurança.

Um servidor abrangente de Model Context Protocol (MCP) que fornece acesso completo à API v5 da Bybit. Este servidor permite que assistentes de IA obtenham dados de mercado em tempo real, executem operações de negociação, gerenciem posições e acessem informações de conta da exchange de criptomoedas Bybit.

🚀 Pronto para Produção

✅ Totalmente Testado - Todos os endpoints testados e funcionando
✅ Suporte a Docker - Imagem publicada disponível em falconiun/bybit-mcp
✅ Integração com VS Code - Configurações prontas para uso fornecidas
✅ Cobertura Abrangente da API - Dados de mercado, negociação, posições e gerenciamento de conta

Recursos

Dados de Mercado Principais

Hora do Servidor: Obtenha a hora atual do servidor Bybit
Tickers: Recupere informações de ticker para símbolos de negociação
Livro de Ordens: Obtenha a profundidade do livro de ordens para qualquer símbolo
Negociações Recentes: Acesse o histórico de negociações recentes

Dados de Kline/Candlestick

Klines Padrão: Obtenha dados de candlestick OHLCV
Klines de Preço de Marcação: Obtenha dados históricos de preço de marcação
Klines de Preço de Índice: Obtenha dados históricos de preço de índice
Klines de Índice Premium: Obtenha dados de preço do índice premium

Informações de Negociação

Informações de Instrumentos: Obtenha informações detalhadas de instrumentos de negociação
Histórico de Taxas de Financiamento: Acesse taxas de financiamento históricas
Juros em Aberto: Obtenha estatísticas de juros em aberto
Limites de Risco: Recupere informações de limites de risco

Estatísticas de Mercado

Fundo de Seguros: Obtenha dados do fundo de seguros
Proporção Long/Short: Acesse estatísticas da proporção long/short

Operações de Negociação (Requer `BYBIT_TRADING_ENABLED=true`)

Gerenciamento de Ordens: Coloque, altere e cancele ordens com controle total
Tipos Avançados de Ordens: Suporte para ordens de Mercado, Limite e condicionais/gatilho
Operações em Lote: Execute múltiplas ordens em uma única solicitação para eficiência
Histórico de Ordens: Visualize histórico abrangente de ordens abertas/fechadas e negociações
Execução em Tempo Real: Obtenha feedback imediato sobre status de ordens e preenchimentos
Ordens de Gatilho: Ordens condicionais com gatilhos de preço e lógica avançada de stop/take profit

Gerenciamento de Posições (Requer `BYBIT_TRADING_ENABLED=true`)

Informações de Posição: Consulte dados de posição em tempo real com métricas detalhadas
Controle de Alavancagem: Defina e modifique a alavancagem da posição dinamicamente
Gerenciamento de Margem: Alterne entre modos de margem cruzada/isolada
Stops de Negociação: Defina take profit, stop loss e trailing stops
Adição Automática de Margem: Configure adição automática de margem
Modos de Posição: Alterne entre modos de posição one-way e hedge
Acompanhamento de P&L: Acesse registros de lucros e perdas fechados

Gerenciamento de Conta e Carteira

Saldo da Carteira: Obtenha informações abrangentes do saldo da carteira
Saldo de Moeda Única: Consulte saldos de moedas específicas
Informações da Conta: Acesse informações e configurações detalhadas da conta
Múltiplos Tipos de Conta: Suporte para contas UNIFIED, CONTRACT, SPOT, INVESTMENT

🎯 Capacidades Principais

✅ Cobertura Completa da API

Dados de Mercado: Todos os endpoints de mercado da Bybit v5 (tickers, livro de ordens, klines, taxas de financiamento, etc.)
Negociação: Gerenciamento completo do ciclo de vida de ordens (colocar, alterar, cancelar, operações em lote)
Ordens Avançadas: Ordens condicionais/gatilho com estratégias sofisticadas de entrada e saída
Posições: Gerenciamento completo de posições (alavancagem, margem, stops, acompanhamento de P&L)
Conta: Saldos de carteira, informações de conta e suporte a múltiplas contas

✅ Design Otimizado para Agentes

Descrições Claras de Ferramentas: Cada ferramenta possui descrições detalhadas e amigáveis para agentes, explicando propósito e uso
Esquemas de Parâmetros Ricos: Esquemas JSON abrangentes com exemplos, enums e restrições de validação
Avisos de Segurança: Ferramentas importantes de negociação incluem avisos de segurança e notificações de risco em destaque
Orientação de Uso: Ferramentas incluem contexto sobre quando e como usá-las efetivamente
Prevenção de Erros: Validação de esquema previne erros comuns de parâmetros antes das chamadas de API

✅ Recursos de Produção

Segurança em Primeiro Lugar: Negociação desativada por padrão, exigindo habilitação explícita
Suporte a Testnet: Integração completa com testnet para desenvolvimento e testes seguros
Tratamento de Erros: Tratamento abrangente de erros com mensagens de erro detalhadas
Validação de Dados: Modelos Pydantic garantem integridade de dados e segurança de tipos
Pronto para Docker: Imagem Docker publicada com tratamento adequado de variáveis de ambiente

✅ Experiência do Desenvolvedor

Integração com VS Code: Configurações prontas para uso para implantação local e Docker
Protocolo MCP: Conformidade total com Model Context Protocol para integração com assistentes de IA
Segurança de Tipos: Tipagem completa estilo TypeScript com modelos Pydantic
Testes: Suíte de testes abrangente com integração real de API
Documentação: Documentação extensa com exemplos e melhores práticas

Categorias Suportadas

Linear: Perpétuos USDT, perpétuos USDC, futuros USDC
Inverso: Perpétuos inversos, futuros inversos
Opções: Negociação de opções
Spot: Pares de negociação spot

Instalação

Pré-requisitos

Python 3.13+
Gerenciador de pacotes uv

Usando uvx (Mais Fácil - Sem Necessidade de Instalação)

Execute diretamente do PyPi sem clonar ou instalar:

uvx bybit-mcp

Usando uv (Recomendado para Desenvolvimento Local)

Clone o repositório:

git clone <repository-url>
cd bybit-mcp

Instale as dependências:

uv sync

Configure as variáveis de ambiente:

# 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

Execute o servidor:

uv run bybit-mcp

Uso com Docker

Build e Execução

# 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 Imagem 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

Configuração

Variáveis de Ambiente

BYBIT_API_KEY: Sua chave de API da Bybit
BYBIT_API_SECRET: Seu segredo de API da Bybit
BYBIT_TESTNET: Defina como true para usar a testnet da Bybit (padrão é false)
BYBIT_TRADING_ENABLED: Defina como true para habilitar operações de negociação (padrão é false)

Controles de Segurança

O servidor implementa vários controles de segurança para operações de negociação:

Negociação Desativada por Padrão

Todas as ferramentas de negociação e gerenciamento de posições estão desativadas por padrão
Deve definir explicitamente BYBIT_TRADING_ENABLED=true para habilitar a negociação
As ferramentas de dados de mercado estão sempre disponíveis independentemente desta configuração

Suporte a Testnet

Defina BYBIT_TESTNET=true para usar o ambiente de testnet da Bybit
Recomendado para desenvolvimento e testes
A negociação na testnet usa dinheiro fictício e não afetará saldos reais

Visibilidade das Ferramentas

As ferramentas de negociação só aparecem na lista de ferramentas quando BYBIT_TRADING_ENABLED=true
As ferramentas de gerenciamento de posições exigem o mesmo sinalizador
Isso previne operações de negociação acidentais

Permissões de API

Garanta que sua chave de API da Bybit tenha as permissões apropriadas:

Somente leitura: Para dados de mercado (sempre seguro)
Negociação: Necessária para operações de ordens (habilite apenas quando necessário)
Posição: Necessária para gerenciamento de posições
Saque: Não necessário para este servidor

Integração com Clientes MCP

Claude Desktop

Para usar o servidor MCP da Bybit com o Claude Desktop, adicione a seguinte configuração ao arquivo de configurações MCP do Claude Desktop:

Localização da configuração MCP do 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

Opção 1: Usando Imagem 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"
      ]
    }
  }
}

Opção 2: Usando uvx (Sem Necessidade de Instalação)

{
  "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"
      }
    }
  }
}

Opção 3: Desenvolvimento 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 do Claude Desktop:

Substitua your_api_key_here e your_api_secret_here pelas suas credenciais reais de API da Bybit
Defina BYBIT_TESTNET=true para testar com dinheiro fictício (recomendado para o primeiro uso)
Defina BYBIT_TRADING_ENABLED=true apenas quando quiser habilitar operações reais de negociação
Reinicie o Claude Desktop após modificar o arquivo de configuração

Exemplos de Uso com Claude Desktop:

Uma vez configurado, você pode fazer perguntas ao Claude Desktop como:

"Qual é o meu saldo em USDT?"
"Qual é o preço atual do BTCUSDT?"
"Mostre-me o livro de ordens para ETHUSDT"
"Obtenha o histórico recente de negociações da minha conta"
"Quais posições eu tenho abertas atualmente?"

Para negociação (quando BYBIT_TRADING_ENABLED=true):

"Coloque uma ordem de compra limite de 0,001 BTC a $95.000"
"Cancele todas as minhas ordens abertas"
"Defina alavancagem de 10x para BTCUSDT"
"Defina um stop loss a $90.000 para minha posição de BTC"

Melhores Práticas de Segurança:

Comece com BYBIT_TESTNET=true para testar a funcionalidade com segurança
Use chaves de API com permissões mínimas necessárias (somente leitura para dados de mercado, permissões de negociação apenas quando necessário)
Nunca compartilhe seu arquivo de configuração contendo chaves de API
Considere usar variáveis de ambiente para credenciais sensíveis em produção

Outros Clientes MCP

Este servidor funciona com qualquer cliente compatível com MCP. O formato de configuração pode variar ligeiramente entre clientes, mas a configuração principal permanece a mesma:

Integração MCP com VS Code

Opção 1: Desenvolvimento Local (Recomendado)

Adicione ao seu settings.json do 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"
      }
    ]
  }
}

Opção 2: Docker (Produção)

Para usar a imagem 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 do Docker:

Os sinalizadores -e são necessários para passar variáveis de ambiente para o contêiner Docker
A seção env define as variáveis no ambiente do VS Code, que são então passadas para o Docker
O sinalizador --init ajuda com o tratamento adequado de sinais em contêineres

Testes

MCP Inspector

Teste o servidor usando o inspetor MCP:

npx @modelcontextprotocol/inspector uv run bybit-mcp

Testes Unitários

uv run pytest tests/

Referência da API

Ferramentas de Dados de Mercado

Todas as ferramentas de dados de mercado estão sempre disponíveis e não exigem permissões especiais.

Dados Principais

get_server_time: Obtenha a hora atual do servidor Bybit
get_tickers: Obtenha informações de ticker para símbolos
get_order_book: Obtenha a profundidade do livro de ordens
get_recent_trades: Obtenha histórico de negociações recentes

Dados de Kline/Candlestick

get_kline: Obtenha dados de kline OHLCV padrão
get_mark_price_kline: Obtenha dados históricos de preço de marcação
get_index_price_kline: Obtenha dados históricos de preço de índice
get_premium_index_price_kline: Obtenha dados de kline do índice premium

Informações de Mercado

get_instruments_info: Obtenha detalhes de instrumentos de negociação
get_funding_rate_history: Obtenha histórico de taxas de financiamento
get_open_interest: Obtenha estatísticas de juros em aberto
get_insurance: Obtenha dados do fundo de seguros
get_risk_limit: Obtenha informações de limites de risco
get_long_short_ratio: Obtenha dados da proporção long/short

Ferramentas de Negociação (Requer `BYBIT_TRADING_ENABLED=true`)

Estas ferramentas estão disponíveis apenas quando a negociação está habilitada via variável de ambiente BYBIT_TRADING_ENABLED.

Gerenciamento de Ordens

place_order: Coloque ordens padrão (Mercado, Limite) para execução imediata ou a preço especificado
place_trigger_order: Coloque ordens condicionais/gatilho com estratégias avançadas de stop-loss, take-profit e entrada de mercado
amend_order: Modifique ordens pendentes existentes (preço, quantidade ou condições de gatilho)
cancel_order: Cancele uma ordem pendente específica
cancel_all_orders: Cancele todas as ordens abertas para melhor gerenciamento de risco

Operações em Lote

batch_place_order: Coloque múltiplas ordens em uma única solicitação
batch_amend_order: Altere múltiplas ordens em uma única solicitação
batch_cancel_order: Cancele múltiplas ordens em uma única solicitação

Informações de Ordens

get_open_closed_orders: Obtenha ordens abertas e fechadas
get_order_history: Obtenha histórico de ordens
get_trade_history: Obtenha histórico de execução de negociações

Gerenciamento de Carteira e Conta

get_wallet_balance: Obtenha informações abrangentes do saldo da carteira
get_single_coin_balance: Obtenha saldo para uma criptomoeda específica
get_account_info: Obtenha informações e configurações detalhadas da conta

Ferramentas de Posição (Requer `BYBIT_TRADING_ENABLED=true`)

As ferramentas de gerenciamento de posições exigem que a negociação esteja habilitada.

Informações de Posição

get_position_info: Consultar dados de posição em tempo real
get_closed_pnl: Obter registros de lucros e perdas fechados

Configuração de Posição

set_leverage: Definir alavancagem da posição
switch_cross_isolated_margin: Alternar modo de margem
switch_position_mode: Alternar entre modo unidirecional/hedge
set_auto_add_margin: Configurar adição automática de margem

Gerenciamento de Risco

set_trading_stop: Definir take profit, stop loss, trailing stops
modify_position_margin: Adicionar ou reduzir margem da posição

Ferramentas

Todas as ferramentas suportam os seguintes parâmetros comuns quando aplicável:

category: Tipo de produto (linear, inverso, opção, spot)
symbol: Símbolo de negociação (ex.: BTCUSDT)
limit: Limite de tamanho de dados por página
start/end: Intervalo de tempo para dados históricos

Exemplos de Chamadas de Ferramentas

Obter Hora do Servidor

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

Obter Dados de Ticker

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

Obter Dados de Kline

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

Colocar Ordem (Requer Negociação Habilitada)

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

Colocar Ordem de Gatilho (Requer Negociação Habilitada)

{
  "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"
  }
}

Obter Informações de Posição (Requer Negociação Habilitada)

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

Definir Alavancagem (Requer Negociação Habilitada)

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

Definir Stop de Negociação (Requer Negociação Habilitada)

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

Obter Saldo da Carteira

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

Obter Saldo de Moeda Única

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

Obter Informações da Conta

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

Recursos

bybit://market/info: Informações gerais sobre endpoints e capacidades disponíveis

Solução de Problemas

Problemas Comuns

Variáveis de Ambiente Não Funcionando no Docker

Problema: chaves de API não estão sendo passadas para o contêiner Docker
Solução: Use o formato de flag -e mostrado na configuração Docker acima
Nota: A seção env nas configurações MCP do VS Code define variáveis no ambiente do VS Code, que são então passadas para o Docker via flags -e

Erros de Validação Pydantic

Problema: incompatibilidades de tipos de dados (ex.: inteiros vs strings)
Solução: O servidor inclui conversão automática de tipos para inconsistências comuns da API
Exemplo: o campo seq no histórico de negociações é convertido automaticamente de int para string

Operações de Negociação Desabilitadas

Problema: ferramentas de negociação não aparecendo ou retornando erros de desabilitado
Solução: Defina BYBIT_TRADING_ENABLED=true nas suas variáveis de ambiente
Segurança: Isso é intencional - a negociação é desabilitada por padrão por segurança

Erros de Permissão da API

Problema: 401 Não Autorizado ou permissões insuficientes
Solução: Verifique se sua chave de API Bybit tem as permissões necessárias:
- Somente leitura: Para dados de mercado (sempre seguro)
- Negociação: Necessária para operações de ordem
- Posição: Necessária para gerenciamento de posição

Modo de Depuração

Habilite o registro de depuração definindo o nível de log:

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

Desenvolvimento

Estrutura do Projeto

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

Contribuindo

Faça um fork do repositório
Crie um branch de funcionalidade
Faça suas alterações
Adicione testes para novas funcionalidades
Execute a suíte de testes
Envie um pull request

Qualidade de Código

O projeto usa:

Ruff: Para linting e formatação
Pytest: Para testes
Pydantic: Para validação de dados
Type hints: Para melhor documentação de código

Atualizações Recentes

v0.1.0 - Lançamento de Produção

✅ Cobertura completa da API Bybit v5 (dados de mercado, negociação, posições, contas)
✅ Imagem Docker publicada em falconiun/bybit-mcp
✅ Corrigidos problemas de validação Pydantic (conversão de tipo do campo seq)
✅ Integração MCP abrangente com VS Code com configuração Docker funcional
✅ Tratamento de erros aprimorado e controles de segurança
✅ Suporte completo para gerenciamento de carteira e conta
✅ Suporte a testnet para desenvolvimento seguro
✅ Pronto para produção com testes abrangentes

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Aviso Legal

Este software é para fins educacionais e de desenvolvimento. Sempre teste minuciosamente antes de usar em ambientes de produção. Os autores não são responsáveis por quaisquer perdas financeiras incorridas pelo uso deste software.

Suporte

Para problemas e perguntas:

Verifique as GitHub Issues existentes
Crie uma nova issue com informações detalhadas
Forneça logs e mensagens de erro quando aplicável

Apoie o Projeto

Se você acha este servidor MCP útil para suas necessidades de negociação e desenvolvimento, considere apoiar seu desenvolvimento contínuo:

Seu apoio ajuda a manter e melhorar este projeto, adicionar novos recursos e garantir compatibilidade com as atualizações mais recentes da API Bybit. Obrigado por considerar uma contribuição!

Agradecimentos

Construído com o Model Context Protocol
Usa a Bybit API v5
Desenvolvido com a biblioteca pybit

Bybit MCP Server

Documentação

Bybit MCP Server

🚀 Pronto para Produção

Recursos

Dados de Mercado Principais

Dados de Kline/Candlestick

Informações de Negociação

Estatísticas de Mercado

Operações de Negociação (Requer BYBIT_TRADING_ENABLED=true)

Gerenciamento de Posições (Requer BYBIT_TRADING_ENABLED=true)

Gerenciamento de Conta e Carteira

🎯 Capacidades Principais

✅ Cobertura Completa da API

✅ Design Otimizado para Agentes

✅ Recursos de Produção

✅ Experiência do Desenvolvedor

Categorias Suportadas

Instalação

Pré-requisitos

Usando uvx (Mais Fácil - Sem Necessidade de Instalação)

Usando uv (Recomendado para Desenvolvimento Local)

Uso com Docker

Build e Execução

Usando Docker Compose

Usando Imagem Publicada

Configuração

Variáveis de Ambiente

Controles de Segurança

Negociação Desativada por Padrão

Suporte a Testnet

Visibilidade das Ferramentas

Permissões de API

Integração com Clientes MCP

Claude Desktop

Outros Clientes MCP

Integração MCP com VS Code

Opção 1: Desenvolvimento Local (Recomendado)

Opção 2: Docker (Produção)

Testes

MCP Inspector

Testes Unitários

Referência da API

Ferramentas de Dados de Mercado

Dados Principais

Dados de Kline/Candlestick

Informações de Mercado

Ferramentas de Negociação (Requer BYBIT_TRADING_ENABLED=true)

Gerenciamento de Ordens

Operações em Lote

Informações de Ordens

Gerenciamento de Carteira e Conta

Ferramentas de Posição (Requer BYBIT_TRADING_ENABLED=true)

Informações de Posição

Configuração de Posição

Gerenciamento de Risco

Ferramentas

Exemplos de Chamadas de Ferramentas

Recursos

Solução de Problemas

Problemas Comuns

Variáveis de Ambiente Não Funcionando no Docker

Erros de Validação Pydantic

Operações de Negociação Desabilitadas

Erros de Permissão da API

Modo de Depuração

Desenvolvimento

Estrutura do Projeto

Contribuindo

Qualidade de Código

Atualizações Recentes

Licença

Aviso Legal

Suporte

Apoie o Projeto

Agradecimentos

Operações de Negociação (Requer `BYBIT_TRADING_ENABLED=true`)

Gerenciamento de Posições (Requer `BYBIT_TRADING_ENABLED=true`)

Ferramentas de Negociação (Requer `BYBIT_TRADING_ENABLED=true`)

Ferramentas de Posição (Requer `BYBIT_TRADING_ENABLED=true`)