Servidor MCP de Alchemy

Un servidor del Protocolo de Contexto de Modelos (MCP) que permite a los agentes de IA interactuar con las API de blockchain de Alchemy de forma estructurada. Esto permite a los agentes consultar datos de blockchain directamente sin escribir código.

Servidor MCP remoto (Recomendado)

La forma más rápida de empezar es conectarse al servidor remoto alojado en https://mcp.alchemy.com/mcp. Se autentica mediante OAuth: simplemente inicia sesión con tu cuenta de Alchemy cuando se te solicite. No se requiere clave de API ni instalación local.

Documentación completa: alchemy.com/docs/alchemy-mcp-server

Nota: El servidor alojado en mcp.alchemy.com y este repositorio de código abierto se mantienen por separado y es posible que no estén sincronizados.

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Para cualquier otro cliente compatible con MCP, apúntalo a https://mcp.alchemy.com/mcp usando transporte HTTP Streamable.

Related MCP server: Substrate MCP Server

Servidor STDIO local

Este servidor MCP crea un puente entre los agentes de IA y las API de blockchain de Alchemy, permitiendo a los agentes:

• Consultar precios de tokens e historial de precios (incluyendo consultas de marcos temporales flexibles)

• Obtener información de propiedad de NFT y datos de contratos

• Ver el historial de transacciones en múltiples redes

• Comprobar saldos de tokens en múltiples redes blockchain

• Recuperar transferencias de activos detalladas con filtrado

• Enviar transacciones a través de Cuentas de Contrato Inteligente (requiere servidor de agente de billetera configurado)

• Ejecutar intercambios de tokens a través de protocolos DEX (requiere servidor de agente de billetera configurado)

• ¡Y más!

Configuración rápida

Para configurar rápidamente el servidor MCP, utiliza la siguiente configuración en tu archivo de configuración MCP (normalmente en la configuración de Claude Desktop o Cursor):

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Esta configuración te permite usar el servidor sin clonar manualmente el repositorio.

Variables de entorno

El servidor MCP requiere la siguiente variable de entorno:

• ALCHEMY_API_KEY - Tu clave de API de Alchemy (requerida para todas las consultas de datos de blockchain)

Para la funcionalidad de transacciones e intercambios, también debes configurar:

• AGENT_WALLET_SERVER - URL de un servidor de agente de billetera configurado que maneje operaciones de Cuentas de Contrato Inteligente

⚠️ Importante: Los métodos sendTransaction y swap no funcionarán sin un servidor de agente de billetera configurado correctamente. Estos métodos requieren una infraestructura de billetera externa para manejar la firma y transmisión de transacciones.

Métodos disponibles

Puedes pedir a tu agente de IA que utilice los siguientes métodos:

Métodos de precio de token

1. fetchTokenPriceBySymbol

   • Obtiene datos de precio actuales para tokens por símbolo

   • Ejemplo: "¿Cuál es el precio actual de ETH y BTC?"

2. fetchTokenPriceByAddress

   • Obtiene datos de precio actuales para tokens por dirección de contrato

   • Ejemplo: "¿Cuál es el precio del token en la dirección 0x1234...5678 en la red principal de Ethereum?"

3. fetchTokenPriceHistoryBySymbol

   • Obtiene datos históricos de precios para tokens con rangos de fechas específicos

   • Ejemplo: "Muéstrame el historial de precios de BTC del 1 de enero al 1 de febrero de 2023, con intervalos diarios"

4. fetchTokenPriceHistoryByTimeFrame

   • Obtiene datos históricos de precios usando marcos temporales flexibles o lenguaje natural

   • Ejemplo: "Muéstrame el precio de ETH de la última semana" o "Obtén el precio de BTC de los últimos 30 días"

Métodos de token multichain

5. fetchTokensOwnedByMultichainAddresses

   • Obtiene saldos de tokens para direcciones en múltiples redes

   • Ejemplo: "¿Qué tokens tiene 0xabc...123 en Ethereum y Base?"

Métodos de historial de transacciones

6. fetchAddressTransactionHistory

   • Obtiene el historial de transacciones para direcciones en múltiples redes

   • Ejemplo: "Muestra las transacciones recientes de la billetera 0xdef...456 en Ethereum"

7. fetchTransfers

   • Obtiene datos detallados de transferencia de activos con opciones de filtrado avanzadas

   • Ejemplo: "Muéstrame todas las transferencias ERC-20 hacia o desde 0xghi...789"

Métodos de NFT

8. fetchNftsOwnedByMultichainAddresses

   • Obtiene todos los NFT propiedad de direcciones con filtrado de spam

   • Ejemplo: "¿Qué NFT posee 0xjkl...012?"

9. fetchNftContractDataByMultichainAddress

   • Obtiene datos de contrato NFT para direcciones

   • Ejemplo: "¿De qué colecciones NFT tiene tokens 0xmno...345?"

Métodos de transacción

10. sendTransaction

    • Envía transacciones a través de Cuentas de Contrato Inteligente

    • ⚠️ Importante: Requiere un servidor de agente de billetera configurado con la variable de entorno AGENT_WALLET_SERVER

    • Ejemplo: "Envía 0.1 ETH a 0xpqr...678"

Métodos de intercambio (Swap)

11. swap

    • Ejecuta intercambios de tokens a través de protocolos DEX (Uniswap)

    • ⚠️ Importante: Requiere un servidor de agente de billetera configurado con la variable de entorno AGENT_WALLET_SERVER

    • Ejemplo: "Intercambia 100 USDC por ETH"

Desarrollo local y contribuciones de código abierto

Instalación

1. Clona el repositorio

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. Instala las dependencias

pnpm install

Desarrollo

pnpm watch

Construcción para producción

pnpm build

Uso del Inspector MCP para depuración

El Inspector MCP te ayuda a depurar tu servidor MCP proporcionando una interfaz visual para probar tus métodos:

pnpm inspector

Esto iniciará el Inspector MCP al que puedes acceder en tu navegador. Te permite:

• Ver todos los métodos disponibles

• Probar métodos con diferentes parámetros

• Ver los datos de respuesta

• Depurar problemas con tu servidor MCP

Contribuciones

Las solicitudes de extracción (pull requests) son bienvenidas. Para cambios importantes, por favor abre un issue primero para discutir lo que te gustaría cambiar.

Licencia

Este servidor MCP tiene licencia bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT.

Ejemplos de prompts

Aquí tienes algunos ejemplos de prompts que puedes usar con tu agente de IA:

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

Referencia de API

Para obtener más información sobre las API de Alchemy, consulta:

• Documentación de la API de Alchemy