WOOFi Pro

Proporciona más de 40 herramientas de trading integrales para la integración con WOOFi Pro y Orderly Network.

Documentación

🚀 Servidor MCP de WOOFi Pro

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona 40 herramientas de trading integrales para la integración con WOOFi Pro y Orderly Network. Construido para compatibilidad universal con Cursor IDE, Claude Desktop, Windsurf y todas las aplicaciones compatibles con MCP.

✨ Características

🎯 Configuración Específica por Plataforma: Comandos estilo Smithery para un direccionamiento preciso del cliente MCP
40 Herramientas de Trading: Suite completa para trading de DeFi y derivados
API de Orderly Network: Integración directa con infraestructura de grado institucional
Compatibilidad Universal: Funciona con Cursor, Claude Desktop, Windsurf y todos los clientes MCP
Configuración Flexible: Auto-configuración, archivos .env o configuración directa: todos los métodos compatibles
Seguridad Estilo CCXT: Las claves API nunca están codificadas en nuestro repositorio, siempre las proporciona el usuario
Autenticación Automática: Autenticación fluida basada en firma ed25519
Soporte Multiplataforma: Claude Desktop, Cursor IDE, VSCode y Windsurf
Gestión Segura de Configuración: Crea copias de seguridad antes de realizar cualquier cambio

🎯 Herramientas Disponibles (40 en Total)

Categoría	Cantidad	Herramientas	Descripción
Cuenta	3	`get_account_info`, `get_positions`, `get_orders`	Información de cuenta y detalles clave
Órdenes	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`	Gestión y ejecución completa de órdenes
Activos	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`	Operaciones de activos, liquidación de PnL y transferencias
Posiciones	3	`get_all_positions`, `get_position_by_symbol`, `get_position_history`	Seguimiento y gestión de posiciones
Liquidaciones	6	`get_liquidated_positions`, `get_liquidations`, `get_positions_under_liquidation`, `claim_liquidated_positions`, `claim_insurance_fund`, `get_insurance_fund`	Monitoreo y reclamos de liquidaciones
Financiamiento	1	`get_funding_fee_history`	Datos e historial de tasas de financiamiento

🚀 Configuración Rápida

🎯 Opción A: Auto-Configuración (Recomendada)

Elige tu plataforma y configura al instante - Comandos 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

Qué hace esto:

🎯 Apunta a una plataforma específica - Configura exactamente lo que quieres
📋 Crea copias de seguridad de las configuraciones existentes
⚙️ Actualiza tu configuración MCP con el servidor WOOFi Pro + credenciales
✅ Listo para usar inmediatamente - ¡solo reinicia tu aplicación MCP!

🟦 Opción B: Método de Archivo .env

Paso 1: Crea el archivo .env

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

Paso 2: Configuración simple (cualquier plataforma)

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

🟩 Opción C: Método de Configuración Directa

Agrega credenciales directamente a tu configuración 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"
      }
    }
  }
}

🔧 Configuración de Credenciales API

🔑 Obtén Credenciales API

Visita: WOOFi Pro
Completa KYC: Se requiere verificación de identidad
Genera Claves API: Gestión de API → Crear claves API
Establece Permisos: Habilita los permisos read y trading
Copia las Credenciales: Necesitarás 3 valores:
- Clave API
- Clave Secreta
- ID de Cuenta

📁 Plantilla de Archivo .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

🔒 Arquitectura de Seguridad

✅ No Sensible (Codificado)

Los siguientes valores estándar están codificados por simplicidad y no son sensibles:

WOOFI_BASE_ENDPOINT=https://api.orderly.org - Endpoint público de API
WOOFI_BROKER_ID=woofi_pro - Identificador estándar de broker
WOOFI_CHAIN_ID=42161 - ID de cadena de red Arbitrum

🔑 Sensible (Proporcionado por el Usuario)

Estos valores deben ser proporcionados por ti y nunca están codificados:

WOOFI_API_KEY - Tu clave API única
WOOFI_SECRET_KEY - Tu clave secreta privada
WOOFI_ACCOUNT_ID - Tu identificador de cuenta

🛡️ Características de Seguridad

🔒 Cero secretos codificados - Siguiendo las mejores prácticas de seguridad MCP 2025
📁 Archivos .env en gitignore - Los secretos nunca se envían al control de versiones
🔐 Carga automática de .env - El servidor encuentra .env en el directorio de trabajo
✅ Validación de entrada - Todos los parámetros validados con esquemas Zod
🏗️ Separación de responsabilidades - Constantes públicas separadas de credenciales privadas

💡 Ejemplos de Uso

Verificar Estado de Cuenta

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

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

Colocar Órdenes

// 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
});

Funciones Avanzadas

// 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 en Lenguaje Natural

Cuenta y Portafolio

"Muéstrame el saldo de mi cuenta"
"¿Cuáles son mis posiciones actuales?"
"Obtén mi historial de transacciones de activos"
"Consulta mi historial de liquidación de PnL"

Trading

"Coloca una orden de compra de mercado por 0.001 BTC"
"Crea una orden de venta limitada de 0.1 ETH a $3500"
"Cancela la orden ID 12345"
"Muéstrame mis órdenes recientes"
"Crea un lote de órdenes"

Operaciones Avanzadas

"Obtén mi nonce de liquidación de PnL"
"Muéstrame posiciones liquidadas"
"Consulta el historial de tarifas de financiamiento para BTC"
"Crea una transferencia interna"

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

📄 Licencia

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

🔗 Enlaces

WOOFi Pro: https://pro.woo.org
Orderly Network: https://orderly.network
Documentación: https://orderly.network/docs
Repositorio de GitHub: https://github.com/DaunteEth/execution-agent

⚡ ¿Listo para operar? Sigue la configuración rápida anterior y comienza a operar con lenguaje natural.