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

Clonar el repositorio

git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad
npm install

Copiar .env.example a .env y configurarlo

cp .env.example .env

Edite .env con su clave privada

nano .env

Construir y ejecutar

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 configurado con: PRIVATE_KEY para las direcciones de contrato Uniswap V2 de la billetera de red de prueba Monad ( UNISWAP_ROUTER_ADDRESS , UNISWAP_FACTORY_ADDRESS ) y la dirección de contrato WMON``(WMON_ADDRESS)

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",
    "stake-aprmon",
    "unstake-aprmon",
    "claim-aprmon",
    "get-aprmon-balance",
    "get-aprmon-rate",
    "get-aprmon-requests",
    "swap"
  ]
});

Configuración del entorno

Para configurar el servidor, copie el archivo de entorno de ejemplo y edítelo:

cp .env.example .env

Edite el archivo .env con un editor de texto (por ejemplo, nano , vim o VS Code ) para incluir lo siguiente:

PRIVATE_KEY=0xyourprivatekeyhere
UNISWAP_ROUTER_ADDRESS=0xfb8e1c3b833f9e67a71c859a132cf783b645e436
UNISWAP_FACTORY_ADDRESS=0x733e88f248b742db6c14c0b1713af5ad7fdd59d0
WMON_ADDRESS=0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite la interacción con la red de pruebas Monad para verificar saldos, examinar detalles de transacciones, obtener precios de gas y recuperar información de bloques.

Related MCP Servers

Flow MCP
Outblock
A
security
A
license
A
quality
Provides tools for interacting with the Flow blockchain, including Flow balance checking, token balance querying, and Cadence Owned Account information retrieval.
Last updated -
5
74
1
TypeScript
MIT License
hackle-mcpofficial
hackle-io
A
security
A
license
A
quality
A Model Context Protocol server for Hackle API providing tools and resources for querying A/B Test data.
Last updated -
76
1
JavaScript
MIT License
MCP Smart Contract Analyst
RockYuan
-
security
-
license
-
quality
Enables interaction with the Monad blockchain to analyze smart contract source code for functionality and security, with decompilation support for unverified contracts.
Last updated -
TypeScript
Apache 2.0
Monad NFT Analytics MCP
Sifu213
-
security
-
license
-
quality
A server that retrieves NFT-related data on the Monad testnet, allowing users to check NFT holders, calculate portfolio values, view collections, and track top-selling NFTs by volume and sales across different time periods.
Last updated -
TypeScript

View all related MCP servers

Monad MCP Server