WOOFi Pro

Fornece mais de 40 ferramentas de trading abrangentes para integração com WOOFi Pro e Orderly Network.

Documentação

🚀 Servidor MCP WOOFi Pro

Um servidor Model Context Protocol (MCP) que fornece 40 ferramentas de negociação abrangentes para integração com WOOFi Pro e Orderly Network. Construído para compatibilidade universal com Cursor IDE, Claude Desktop, Windsurf e todos os aplicativos compatíveis com MCP.

✨ Recursos

🎯 Configuração Específica por Plataforma: Comandos no estilo Smithery para direcionamento preciso de clientes MCP
40 Ferramentas de Negociação: Conjunto completo para negociação DeFi e de derivativos
API Orderly Network: Integração direta com infraestrutura de nível institucional
Compatibilidade Universal: Funciona com Cursor, Claude Desktop, Windsurf e todos os clientes MCP
Configuração Flexível: Auto-config, arquivos .env OU configuração direta - todos os métodos suportados
Segurança no Estilo CCXT: Chaves de API nunca embutidas no código do nosso repositório, sempre fornecidas pelo usuário
Autenticação Automática: Autenticação baseada em assinatura ed25519 sem interrupções
Suporte Multi-Plataforma: Claude Desktop, Cursor IDE, VSCode e Windsurf
Gerenciamento Seguro de Configuração: Cria backups antes de fazer qualquer alteração

🎯 Ferramentas Disponíveis (40 no Total)

Categoria	Quantidade	Ferramentas	Descrição
Conta	3	`get_account_info`, `get_positions`, `get_orders`	Informações da conta e detalhes principais
Ordens	18	`create_order`, `batch_create_orders`, `edit_order`, `cancel_order`, `cancel_order_by_client_id`, `cancel_all_pending_orders`, `cancel_all_after`, `get_orders`, `get_order_by_id`, `get_order_by_client_id`, `create_algo_order`, `edit_algo_order`, `cancel_algo_order`, `cancel_algo_order_by_client_id`, `cancel_all_pending_algo_orders`, `get_algo_orders`, `get_algo_order_by_id`, `get_algo_order_by_client_id`	Gerenciamento e execução completa de ordens
Ativos	8	`get_asset_history`, `get_holdings`, `create_withdraw_request`, `get_settle_pnl_nonce`, `request_pnl_settlement`, `get_pnl_settlement_history`, `create_internal_transfer`, `get_internal_transfer_history`	Operações de ativos, liquidação de PnL e transferências
Posições	3	`get_all_positions`, `get_position_by_symbol`, `get_position_history`	Rastreamento e gerenciamento de posições
Liquidações	6	`get_liquidated_positions`, `get_liquidations`, `get_positions_under_liquidation`, `claim_liquidated_positions`, `claim_insurance_fund`, `get_insurance_fund`	Monitoramento e reivindicações de liquidação
Funding	1	`get_funding_fee_history`	Dados e histórico de taxas de funding

🚀 Configuração Rápida

🎯 Opção A: Auto-Configuração (Recomendado)

Escolha sua plataforma e configure instantaneamente - comandos no estilo Smithery:

Claude Desktop:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \
  --client claude \
  --api-key=your_orderly_api_key_here \
  --secret-key=your_orderly_secret_key_here \
  --account-id=your_account_id_here

Cursor IDE:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \
  --client cursor \
  --api-key=your_orderly_api_key_here \
  --secret-key=your_orderly_secret_key_here \
  --account-id=your_account_id_here

VSCode:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \
  --client vscode \
  --api-key=your_orderly_api_key_here \
  --secret-key=your_orderly_secret_key_here \
  --account-id=your_account_id_here

Windsurf:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp.git woofi-pro \
  --client windsurf \
  --api-key=your_orderly_api_key_here \
  --secret-key=your_orderly_secret_key_here \
  --account-id=your_account_id_here

O que isso faz:

🎯 Direciona plataforma específica - Configure exatamente o que deseja
📋 Cria backups das configurações existentes
⚙️ Atualiza sua configuração MCP com o servidor WOOFi Pro + credenciais
✅ Pronto para uso imediato - basta reiniciar seu aplicativo MCP!

🟦 Opção B: Método do Arquivo .env

Passo 1: Crie o arquivo .env

cp .env.example .env
# Edit .env with your credentials

Passo 2: Configuração simples (qualquer plataforma)

{
  "mcpServers": {
    "woofi-pro": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/DaunteEth/woofi-pro-mcp",
        "woofi-pro"
      ]
    }
  }
}

🟩 Opção C: Método de Configuração Direta

Adicione credenciais diretamente à sua configuração MCP:

Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "woofi-pro": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/DaunteEth/woofi-pro-mcp",
        "woofi-pro"
      ],
      "env": {
        "WOOFI_API_KEY": "your_orderly_api_key_here",
        "WOOFI_SECRET_KEY": "your_orderly_secret_key_here",
        "WOOFI_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}

Cursor IDE (.cursor/mcp.json)

{
  "mcpServers": {
    "woofi-pro": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/DaunteEh/execution-agent.git",
        "woofi-pro"
      ],
      "env": {
        "WOOFI_API_KEY": "your_orderly_api_key_here",
        "WOOFI_SECRET_KEY": "your_orderly_secret_key_here",
        "WOOFI_ACCOUNT_ID": "your_account_id_here"
      }
    }
  }
}

🔧 Configuração de Credenciais da API

🔑 Obter Credenciais da API

Visite: WOOFi Pro
Complete o KYC: Verificação de identidade necessária
Gere Chaves de API: Gerenciamento de API → Criar chaves de API
Defina Permissões: Habilite as permissões read e trading
Copie as Credenciais: Você precisará de 3 valores:
- Chave de API
- Chave Secreta
- ID da Conta

📁 Modelo do Arquivo .env

# WOOFi Pro API Credentials (Required)
WOOFI_API_KEY=your_orderly_api_key_here
WOOFI_SECRET_KEY=your_orderly_secret_key_here
WOOFI_ACCOUNT_ID=your_account_id_here

🔒 Arquitetura de Segurança

✅ Não Sensível (Embutido no Código)

Os seguintes valores padrão são embutidos no código para simplificar e não são sensíveis:

WOOFI_BASE_ENDPOINT=https://api.orderly.org - Endpoint público da API
WOOFI_BROKER_ID=woofi_pro - Identificador padrão do corretor
WOOFI_CHAIN_ID=42161 - ID da rede Arbitrum

🔑 Sensível (Fornecido pelo Usuário)

Estes valores devem ser fornecidos por você e nunca são embutidos no código:

WOOFI_API_KEY - Sua chave de API exclusiva
WOOFI_SECRET_KEY - Sua chave secreta privada
WOOFI_ACCOUNT_ID - Seu identificador de conta

🛡️ Recursos de Segurança

🔒 Zero segredos embutidos no código - Seguindo as melhores práticas de segurança MCP 2025
📁 Arquivos .env no gitignore - Segredos nunca enviados ao controle de versão
🔐 Carregamento automático de .env - O servidor encontra o .env no diretório de trabalho
✅ Validação de entrada - Todos os parâmetros validados com esquemas Zod
🏗️ Separação de responsabilidades - Constantes públicas separadas de credenciais privadas

💡 Exemplos de Uso

Verificar Status da Conta

// Get account information
await get_account_info({});

// View all positions  
await get_all_positions({});

Colocar Ordens

// Market buy order
await create_order({
  symbol: "PERP_BTC_USDC",
  side: "BUY", 
  order_type: "MARKET",
  order_quantity: 0.001
});

// Limit sell order
await create_order({
  symbol: "PERP_ETH_USDC",
  side: "SELL",
  order_type: "LIMIT", 
  order_price: 3500,
  order_quantity: 0.1
});

Recursos Avançados

// PnL Settlement
await get_settle_pnl_nonce({});
await request_pnl_settlement({
  signature: "0x...",
  userAddress: "0x...",
  // ... EIP-712 signature data
});

// Liquidation Claims  
await claim_liquidated_positions({
  liquidation_id: 12345,
  // ... liquidation claim data
});

🔄 Comandos em Linguagem Natural

Conta e Portfólio

"Mostre meu saldo da conta"
"Quais são minhas posições atuais?"
"Obtenha meu histórico de transações de ativos"
"Verifique meu histórico de liquidação de PnL"

Negociação

"Coloque uma ordem de compra a mercado de 0,001 BTC"
"Crie uma ordem de venda limitada de 0,1 ETH a $3500"
"Cancele a ordem ID 12345"
"Mostre minhas ordens recentes"
"Crie um lote de ordens"

Operações Avançadas

"Obtenha meu nonce de liquidação de PnL"
"Mostre posições liquidadas"
"Verifique o histórico de taxas de funding para BTC"
"Crie uma transferência interna"

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📄 Licença

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

🔗 Links

WOOFi Pro: https://pro.woo.org
Orderly Network: https://orderly.network
Documentação: https://orderly.network/docs
Repositório GitHub: https://github.com/DaunteEth/execution-agent

⚡ Pronto para negociar? Siga a configuração rápida acima e comece a negociar com linguagem natural!