Servidor Coin MCP 🚀💰

Bienvenido al servidor Coin MCP : tu plataforma única para obtener los precios de criptomonedas más recientes en un abrir y cerrar de ojos. 🌙 Creado con FastMCP y optimizado con zod para validación, este pequeño servidor está aquí para obtener precios de tokens de la API de Bitget como un fiel mayordomo de criptomonedas. 🧑‍💼

Chino tradicional | Inglés

¿Qué hace? 🤔

Este proyecto crea un servidor que te permite consultar el precio actual de cualquier criptomoneda (vinculada a USDT) mediante la elegante API de Bitget. ¿Quieres saber cuánto vale tu token favorito ahora mismo? ¡Solo pregúntalo y listo! ¡El precio es tuyo! 💸

Herramienta : getTokenPrice
Misión : Obtener el último precio de un token (por ejemplo, BGB , BTC , ETH ).
Superpoder : ¡Es rápido, es simple y está impulsado por FastMCP ! ⚡
Herramienta : getAnnoucements
Misión : recibir anuncios
Herramienta : getCoinInfo
Misión : Obtener información detallada sobre un token específico.
Superpotencia : proporciona información detallada como transferibilidad de tokens, lista de cadenas compatibles, estado de la red de la cadena, etc.

Características 🌟

🎯 API súper simple : Pasa un símbolo de token y obtén un precio. Sin complicaciones.
🛡️ Validación de Zod : Los parámetros se verifican con más rigor que la puerta de una bóveda.
📡 Integración con Bitget : extrae datos en vivo directamente desde la API de ticker de mercado de Bitget.
Manejo de errores : detecta el hipo como un profesional y lo registra para que puedas reírte de ello más tarde.

Empezando 🏁

¿Listo para sumergirte en el mercado de las criptomonedas? Aquí te explicamos cómo poner en marcha esta plataforma:

Prerrequisitos

Deno : Necesitarás tener Deno instalado porque somos sofisticados y modernos. Consíguelo aquí .
Acceso a la API de Bitget : No se necesita clave API. ¡Llegamos al punto final público como campeones! Pero si tienes una BGURL personalizada, configúrala como variable de entorno.

Instalación

Clona este repositorio como si estuviera caliente:
git clone https://github.com/pwh-pwh/coin-mcp-server.git cd coin-mcp-server
Instalar dependencias (Deno maneja esto automáticamente a través de importaciones).

Ejecución del servidor

Enciéndelo con:

deno run --allow-net --allow-env --allow-read main.ts

deno run --allow-net --allow-env --allow-read https://deno.land/x/coin_mcp_server/main.ts

--allow-net : nos permite hablar con la API de Bitget.
--allow-env : toma su variable de entorno BGURL si ha configurado una.

El servidor se iniciará en modo stdio , ¡listo para ofrecer precios como una máquina expendedora de criptomonedas! 🍔

Admite instalación gratuita, implementación directa en deno, bifurcación de este proyecto, inicio de sesión en dash.deno.com, configure la variable de entorno StartType=sse para usar el nombre de dominio proporcionado por deno para conectarse en modo sse

Configuración

config.json

{
  "mcpServers": {
    "coin-mcp": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-read",
        "--allow-env",
        "https://deno.land/x/coin_mcp_server/main.ts"
      ]
    }
  }
}

Ejemplo de uso 🎮

Así es como llamarías getTokenPrice :

{
  "tool": "getTokenPrice",
  "parameters": {
    "token": "BGB"
  }
}

Respuesta :

"42.069"  // The latest BGB/USDT price (not a real price, just vibes!)

Si el token no existe o la API falla, arrojará un error con un registro para recordarle que hizo lo mejor que pudo. 😅

Avance del código 👀

Aquí está la magia detrás de la cortina:

FastMCP : activa el servidor con un nombre y una versión geniales.
Zod : mantiene su parámetro token bajo control.
API de Bitget : obtiene datos de tickers de https://api.bitget.com/api/v2/spot/market/tickers .

La función getBitgetPrice es el MVP, ya que obtiene el lastPr precio de la respuesta. ¡Consulta los registros para ver si hay actualizaciones de precios o errores! 😂

Variables de entorno 🌍

BGURL : URL base personalizada de la API de Bitget (si no se configura, el valor predeterminado es https://api.bitget.com ). Configúrela así:
export BGURL="https://your-custom-bitget-url.com"

Solución de problemas 🛠️

“¡Error HTTP! Estado: 404” : Verifique el símbolo de su token. ¡ BGBUSDT no es lo mismo que BGB !
“Error de red” : asegúrate de tener Internet y el indicador --allow-net de Deno.
¿Sigues atascado? Grita al vacío (o abre un problema). ¡Lo resolveremos juntos! 🙌

¿Por qué existe esto?

¿Quién no quiere saber el precio de sus criptomonedas en tiempo real? Ya seas trader, HODLer o simplemente un apasionado de las criptomonedas, este servidor te cubre las espaldas. Además, es una forma divertida de practicar tus habilidades en Deno y experimentar con las API. 😎

Contribuyendo 🤝

¿Tienes ideas? ¿Encontraste un error? ¿Quieres añadir una función como la predicción del precio de las fases lunares? ¡Bifurca, modifícalo y publica! Hagamos de este el servidor MCP más genial de la galaxia. 🌌

Licencia 📜

MIT – Haz lo que quieras con él, ¡pero no me culpes si tu token se cae o se desploma! 🌑📉

¡Feliz caza de criptomonedas y que tus bolsas siempre sean verdes! 💚

Integrations