Servidor MCP de Monad

Este proyecto proporciona un servidor MCP para una interacción fluida con la red de pruebas Monad. Permite consultar datos de la blockchain (saldos, transacciones, precios del gas, bloques) e interactuar con el contrato inteligente CoinflipGame para jugar a un juego de lanzamiento de moneda. El servidor se integra con Claude Desktop, lo que permite a los usuarios ejecutar comandos en lenguaje natural.

Funciones compatibles y cómo usarlas

Característica	Descripción	Comando de ejemplo
obtener-saldo-mon	Verifique el saldo de MON para obtener una dirección de red de prueba de Monad.	`check MON 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
obtener saldo de tokens	Verifique el saldo de un token ERC-20 específico para una dirección.	`check token balance for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contract 0x1234...5678`
obtener detalles de la transacción	Recupere información detallada sobre una transacción por su hash.	`get details for transaction 0xabcdef1234567890...`
obtener precio de la gasolina	Obtenga el precio actual del gas en la red de pruebas Monad.	`what is the current gas price`
obtener-el-último-bloque	Obtenga información sobre el último bloque en la red de pruebas Monad.	`show latest block info`
obtener-múltiples-saldos	Consultar saldos de múltiples tokens para una dirección.	`check multiple balances for 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765 on contracts 0x1234...5678, 0x5678...1234`
enviar-mon	Envía tokens MON a una dirección específica en la red de prueba Monad.	`send 0.1 MON to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765`
token de envío	Envía tokens ERC-20 a una dirección específica desde un contrato de token.	`send 100 USDT to 0xb3f57a3A7744eA20B5E2848817e9D66C6cb9f765 from contract 0x1234...5678`
jugar al lanzamiento de moneda	Juega un juego de lanzamiento de moneda apostando MON a cara o cruz (apuesta mínima: 0,01 MON).	`flip 0.1 mon head`
obtener el historial de lanzamiento de moneda	Vea el historial de juegos de lanzamiento de moneda para una dirección, incluidas victorias, derrotas y ganancias.	`history flip` o `history flip 0xa2e57a3A7744eA20B5E2848817e9D66C6cb9f765`
estaca-aprmon	Apueste sus tokens MON en la plataforma de staking Apriori.	`stake 0.1 mon` para apostar tokens MON.
unstake-aprmon	Desactive todos sus tokens MON de la plataforma Apriori.	`unstake aprmon` para deshacer todos tus tokens MON en staking. Anota el ID de la solicitud, que se usará más adelante para reclamar.
reclamo-aprmon	Reclamación de tokens MON pendientes sin staking.	Después de 10 minutos de deshacer el staking, usa `claim aprmon requestID` . Reemplaza `requestID` con el ID obtenido durante el proceso de deshacer el staking.
intercambio	Función de intercambio Uniswap V2 integrada para la red Monad Testnet	Para tokens listados: `swap 0.1 MON to USDT` . Para tokens no listados: `swap 0.1 MON to 0xxxxxxxxxxx` (usando la dirección del contrato).

Inicio rápido

# Clone the repository
git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad

# Install dependencies
npm install

# Create .env file (replace with your private key)
echo "PRIVATE_KEY=0xyourprivatekeyhere" > .env

# Build and run
npm run build
node build/index.js

Prerrequisitos

Node.js (v16 o más reciente)
npm o hilo
Claude Desktop (para la integración del cliente MCP)
Una billetera de prueba Monad con suficiente MON para transacciones y tarifas de gas (requerida para play-coinflip, send-mon y send-token)
Un archivo .env con una PRIVATE_KEY válida para la billetera de red de prueba Monad

Configuración y uso

Inicialización del servidor MCP

En el archivo src/index.ts , el servidor se inicializa con la lista de funciones compatibles:

const server = new McpServer({
  name: "monad-testnet",
  version: "0.0.1",
  capabilities: [
    "get-mon-balance",
    "get-token-balance",
    "get-transaction-details",
    "get-gas-price",
    "get-latest-block",
    "get-multiple-balances",
    "send-mon",
    "send-token",
    "play-coinflip",
    "get-coinflip-history"
  ]
});

Configuración del entorno

Cree un archivo .env en el directorio raíz del proyecto (por ejemplo, /path/to/mcp-monad/.env ) con el siguiente contenido:

PRIVATE_KEY=0xyourprivatekeyhere

Reemplace 0xyourprivatekeyhere con la clave privada de su billetera de red de prueba Monad (64 caracteres hexadecimales que comienzan con 0x ).

Asegúrese de que el archivo .env sea seguro y no esté sujeto al control de versiones. Añádalo a .gitignore :

echo .env >> .gitignore

Construyendo y ejecutando el servidor

Construir el proyecto:

npm run build

Ejecute el servidor MCP:

node build/index.js

Integración con Claude Desktop

Abra Claude Desktop.
Vaya a Settings > Developer .
Edite claude_desktop_config.json (normalmente ubicado en ~/.config/Claude/ o %APPDATA%\Claude\ ) y agregue la siguiente configuración:

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-monad/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Reemplace /path/to/mcp-monad/ con la ruta real al directorio de su proyecto (por ejemplo, E:\proyek\mcp-monad en Windows o /home/user/mcp-monad en Linux).

Reinicie Claude Desktop.
Cuando se le solicite, permita el acceso de MCP a la sesión de chat ( Allow for This Chat ).

Contribuyendo

Bifurcar el proyecto
Crea tu rama de funciones ( git checkout -b feature/AmazingFeature )
Confirme sus cambios ( git commit -m 'Add some AmazingFeature' )
Empujar a la rama ( git push origin feature/AmazingFeature )
Abrir una solicitud de extracción

Licencia

Distribuido bajo la licencia MIT. Consulte LICENSE para más información.

Contacto

¡Qué risa! - @caridipesbuk

Enlace del proyecto: https://github.com/Semutireng22/mcp-monad

Notas

Asegúrate de que el contrato de CoinflipGame ( 0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b ) tenga fondos suficientes para cubrir las posibles ganancias de play-coinflip . Puedes comprobarlo con un explorador de bloques de Monad Testnet.
Para los usuarios en diferentes sistemas, ajuste la ruta del proyecto en claude_desktop_config.json según corresponda.

Solución de problemas

El servidor no se inicia : Revise los registros en Claude Desktop ( Settings > Developer ) o la terminal para detectar errores como "El archivo .env no existe". Asegúrese de que .env esté en la raíz del proyecto con una PRIVATE_KEY válida.
Fondos de contrato insuficientes : Verifique el saldo del contrato de CoinflipGame con un explorador de bloques. El titular del contrato puede financiarlo mediante la función fundGamePool .
Los comandos de Claude no funcionan : asegúrese de que claude_desktop_config.json tenga la ruta de proyecto correcta y reinicie Claude Desktop.
Errores de TypeScript : Ejecute npx tsc para comprobar si hay errores. Actualice las dependencias con:

npm install

Utilice MCP Inspector para depurar :

git clone https://github.com/modelcontextprotocol/inspector
cd inspector
npm install
npm start

Monad MCP Server

Integrations