Servidor MCP de Zebpay

Servidor MCP (Model Context Protocol) de TypeScript listo para producción para las APIs de spot y futuros de Zebpay, que utiliza solo transporte stdio. El Model Context Protocol (MCP) es una forma estándar de que los asistentes de IA llamen de forma segura a herramientas y fuentes de datos. Está diseñado para clientes MCP como Cursor, Claude Desktop y MCP Inspector que se conectan mediante la ejecución de procesos locales. El servidor proporciona flujos de trabajo tanto de datos de mercado como de trading, con validación estricta, gestión segura de errores y observabilidad amigable para desarrolladores.

Qué ofrece este servidor

• Herramientas públicas de datos de mercado (spot + futuros)

• Herramientas privadas de trading/cuenta (requieren credenciales de API)

• Recursos MCP y prompts para flujos de trabajo de agentes

• Validación de solicitudes mediante Zod

• Gestión estructurada de errores y registro en archivo opcional

Related MCP server: Cashfree MCP Server

Características

• Servidor MCP solo-stdio para integración local segura con clientes MCP

• Cobertura de las APIs de spot y futuros para operaciones públicas y autenticadas

• Flujo de solicitudes autenticadas basado en HMAC para endpoints privados

• Validación de entrada y respuestas de error MCP normalizadas

• Reintentos de solicitudes salientes y controles de tiempo de espera

• Registro estructurado en archivo opcional para depuración y auditoría

Herramientas compatibles

Spot (público + privado)

• Datos de mercado: tickers, order book, operaciones, klines, información de exchange, monedas

• Trading: realizar órdenes de mercado/límite, cancelar órdenes, cancelar por símbolo, cancelar todas

• Cuenta: saldos, órdenes abiertas, historial de órdenes, historial de operaciones, comisión del exchange

• Ejemplos de nombres de herramientas:

  • zebpay_public_getTicker

  • zebpay_public_getOrderBook

  • zebpay_spot_placeMarketOrder

  • zebpay_spot_placeLimitOrder

  • zebpay_spot_getBalance

Futuros (público + privado)

• Datos de mercado: estado de salud, mercados, información de mercado, order book, ticker de 24h, operaciones agregadas

• Trading/cuenta: saldo de wallet, realizar orden, añadir/reducir margen, órdenes abiertas, posiciones

• Historial: historial de órdenes, órdenes vinculadas, historial de operaciones, historial de transacciones

• Ejemplos de nombres de herramientas:

  • zebpay_futures_public_getMarkets

  • zebpay_futures_public_getOrderBook

  • zebpay_futures_placeOrder

  • zebpay_futures_getWalletBalance

  • zebpay_futures_getPositions

Stack tecnológico

• Node.js (ESM)

• TypeScript

• @modelcontextprotocol/sdk

• undici

• zod

Estructura del proyecto

src/
├── index.ts                  # Stdio MCP server entrypoint
├── mcp/                      # Tools, resources, prompts, MCP errors/logging
├── private/                  # Authenticated Zebpay clients
├── public/                   # Public market-data clients
├── security/                 # Credentials + signing helpers
├── http/                     # Shared outbound HTTP client to Zebpay APIs
├── validation/               # Schemas and validation helpers
├── utils/                    # Caching, metrics, formatting, file logging
└── types/                    # Shared response types

Requisitos previos

• Node.js 20+

• npm 9+

• Credenciales de API de Zebra (para herramientas privadas)

• Crea tu clave/secreto de API desde el portal oficial de la API de ZebPay: https://api.zebpay.com/

Creación de una clave de API de ZebPay

Sigue los pasos siguientes para generar credenciales de API para este servidor MCP:

1. Abre el portal de la API de ZebPay: https://api.zebpay.com/

2. Inicia sesión en tu cuenta de ZebPay.

3. Ve a API Trading y haz clic en Create New API Key.

4. Introduce los detalles de la clave:

   • nombre de la clave (por ejemplo: zebpay-mcp-local)

   • permisos requeridos (solo lectura para consultas de mercado/cuenta, permisos de trading solo si es necesario)

   • lista blanca de IP opcional (recomendada para mayor seguridad)

5. Completa la verificación OTP.

6. Copia y guarda:

   • Clave de API

   • Clave secreta (se muestra una vez)

A continuación añádelas a tu archivo .env local:

ZEBPAY_API_KEY=your_api_key
ZEBPAY_API_SECRET=your_api_secret

Notas de seguridad:

• Nunca hagas commit de claves/secretos de API a git.

• Prefiere los permisos de API con privilegios mínimos.

• Rota las claves inmediatamente si se exponen.

Configuración

git clone <your-repo-url>
cd zebpay-mcp-server
npm install
cp env.example .env

Actualiza .env (todos los valores se leen del entorno; no hay valores predeterminados en el código):

ZEBPAY_API_KEY=your_api_key    # Use the API key from the step above
ZEBPAY_API_SECRET=your_api_secret    # Use the Secret key from the step above
ZEBPAY_SPOT_BASE_URL=https://sapi.zebpay.com/api/v2
ZEBPAY_FUTURES_BASE_URL=https://futuresbe.zebpay.com/api/v1
ZEBPAY_MARKET_BASE_URL=https://www.zebapi.com/api/v1/market
MCP_TRANSPORTS=stdio
LOG_LEVEL=info
HTTP_TIMEOUT_MS=15000
HTTP_RETRY_COUNT=2

Compilar y ejecutar

npm run build
npm start

Registro opcional en archivo:

npm run start:log

Configuración del cliente MCP (Stdio)

Ejemplo de configuración de cliente MCP:

{
  "mcpServers": {
    "zebpay": {
      "command": "node",
      "args": [
          "/absolute/path/to/zebpay-mcp-server/dist/index.js"
        ],
      "env": {
        "ZEBPAY_API_KEY": "YOUR_API_KEY_HERE",
        "ZEBPAY_API_SECRET": "YOUR_API_SECRET_HERE",
        "LOG_LEVEL": "info"
      }
    }
  }
}

[](https://cursor.com/en/install-mcp?name=zebpay\\\\&config=eyJjb21tYW5kIjoibm9nZSIsImFyZ3MiOlsiL2Fic29sdXRlL3BhdGgvdG8sVemVicGF5LW1jcC1zZ2ZXIvZGlzdC9pbmRleC5qcyJdLCJlbnYiOnsiWkVCUEFZX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVlfSEVSRSIsIlpFQlBBWV9BUElfU0VDUkVUIjoiWU9VUl9BUElfU0VDUkVUX0hFUkUiLCJMT0dfTEVWRUwiOiJpbmZvIn19}

Consulta también: mcp-config.json.example.

Variables de entorno

Comandos para desarrolladores

npm run build
npm test
npm run test:watch
npm run logs
npm run logs:watch
npm run logs:errors
npm run logs:stats
npm run logs:clear

Registro

• Herramientas y ejemplos de registro: scripts/README.md

• Documentación completa de registro: docs/LOGGING.md

• Mantén los registros fuera de git (logs/ se ignora)

Problemas

¿Encontraste un error o quieres solicitar una función?

• Crea un issue desde la pestaña Issues de GitHub para este repositorio.

• También puedes usar enlaces directos después de reemplazar <your-org> y <your-repo>:

  • Informe de error: https://github.com/<your-org>/<your-repo>/issues/new?template=bug_report.md

  • Solicitud de función: https://github.com/<your-org>/<your-repo>/issues/new?template=feature_request.md

• Incluye estos detalles para una clasificación más rápida:

  • Cliente MCP utilizado (Cursor/Claude Desktop/otro)

  • Versión de Node.js y sistema operativo

  • Pasos mínimos de reproducción

  • Registros relevantes (oculta los secretos)

Licencia

MIT