MCP Alfa de Binance

Un servidor MCP para rastrear las operaciones de Binance Alpha, ayudando a los agentes de IA a optimizar la acumulación de puntos alfa.

Características

• Monitoreo comercial en tiempo real : realice un seguimiento de la actividad del lado comprador de los tokens Binance Alpha suscribiéndose a eventos en cadena.

• Métricas basadas en USD : calcula los valores comerciales en USD utilizando precios en tiempo real de CryptoCompare.

• Persistencia de datos : mantiene los datos comerciales en la memoria, con limpieza automática de registros con más de 1 hora de antigüedad.

• Herramientas MCP :

  • get_top_tokens : Devuelve una tabla de rebajas de los principales tokens por volumen de negociación en USD, incluido el símbolo, el volumen en USD, el nombre y la dirección.

  • get_trade_stats : proporciona estadísticas sobre los valores comerciales en USD (mínimo, máximo, mediana) y una tabla de distribución.

• Puntos finales configurables : utiliza puntos finales WebSocket ( WS_ENDPOINT ) y HTTP ( RPC_ENDPOINT ) separados para escuchar eventos y consultas de tokens.

Prerrequisitos

• Node.js : Versión 18 o superior.

• npm : Para la gestión de dependencias.

• Acceso a nodo BSC : un punto final WebSocket para escuchar eventos y un punto final HTTP RPC para consultas de tokens, que se pueden obtener de servicios como Infura o QuikNode.

Instalación

1. Clonar el repositorio :

   git clone https://github.com/kukapay/binance-alpha-mcp.git cd binance-alpha-mcp

2. Instalar dependencias :

   npm install

3. Configurar el cliente MCP : para utilizar este servidor con un cliente MCP como Claude Desktop, agregue lo siguiente a su archivo de configuración (o equivalente):

   { "mcpServers": { "binance-alpha-mcp": { "command": "node", "args": ["/absolute/path/to/binance-alpha-mcp/index.js"], "env": { "WS_ENDPOINT": "your_ws_endpoint_url", "RPC_ENDPOINT": "your_rpc_endpoint_url" } } } }

   Reemplace /absolute/path/to/binance-alpha-mcp con su ruta de instalación real y actualice WS_ENDPOINT y PRC_ENDPOINT con sus propias URL de punto final.

Uso

El servidor expone dos herramientas MCP:

obtener_tokens_superiores

• Descripción : Devuelve una tabla de rebajas de los principales tokens por volumen de negociación en USD.

• Entrada : { limit: number } (opcional, valor predeterminado: 10). Especifica cuántos tokens se incluirán en la salida.

• Ejemplo de salida :

  period: last 23 minutes | Symbol | USD Volume | Name | Address | |--------|------------|------|---------| | ZK | $72516.34 | Polyhedra Network | 0xc71b5f631354be6853efe9c3ab6b9590f8302e81 | | B2 | $22893.72 | BSquared Token | 0x783c3f003f172c6ac5ac700218a357d2d66ee2a2 | | AIOT | $5249.05 | OKZOO | 0x55ad16bd573b3365f43a9daeb0cc66a73821b4a5 | | gorilla | $3263.95 | gorilla | 0xcf640fdf9b3d9e45cbd69fda91d7e22579c14444 | | BOOP | $2046.32 | BOOP | 0x9a70815dfb644a24b57358e1041f8d0324c8f6e1 | | BANK | $1305.38 | Lorenzo Governance Token | 0x3aee7602b612de36088f3ffed8c8f10e86ebf2bf | | SKYAI | $1015.69 | SKYAI | 0x92aa03137385f18539301349dcfc9ebc923ffb10 | | KOGE | $672.59 | BNB48 Club Token | 0xe6df05ce8c8301223373cf5b969afcb1498c5528 | | MYX | $477.85 | MYX | 0xd82544bf0dfe8385ef8fa34d67e6e4940cc63e16 | | Drama | $108.37 | Drama | 0xf922fb5f88c19f363cb018e8f7c98c10ed294444 |

obtener estadísticas comerciales

• Descripción : Devuelve estadísticas sobre los valores comerciales en USD, incluidos el mínimo, el máximo, la mediana y la distribución.

• Entrada : { buckets: number } (opcional, valor predeterminado: 10). Especifica el número de buckets para dividir la distribución comercial por el valor en USD.

• Ejemplo de salida :

  period: last 1 minutes min: $0.30, max: $2469.14, median: $653.41 | range | count | |-------|-------| | 0.30~247.19 | 26 | | 247.19~494.07 | 22 | | 494.07~740.95 | 39 | | 740.95~987.84 | 6 | | 987.84~1234.72 | 16 | | 1234.72~1481.61 | 9 | | 1481.61~1728.49 | 1 | | 1728.49~1975.38 | 6 | | 1975.38~2222.26 | 10 | | 2222.26~2469.14 | 2 |

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.