Alchemy MCP Server

Alchemy MCP Server (Legado — No mantenido activamente)

Este servidor de código abierto del Model Context Protocol (MCP) ejecuta las APIs blockchain de Alchemy localmente a través de STDIO. Los nuevos usuarios deberían usar el Alchemy MCP Server alojado en su lugar.

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: solo inicia sesión con tu cuenta de Alchemy cuando se te solicite. No se requiere clave API ni instalación local.

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

Aviso de legado: El Alchemy MCP Server alojado en https://mcp.alchemy.com/mcp es el servidor MCP recomendado y mantenido activamente. Este repositorio contiene el servidor STDIO local heredado, no se mantiene activamente y puede quedar rezagado respecto a la cobertura de herramientas y el comportamiento del servidor alojado. Alchemy planea retirar este repositorio; los nuevos usuarios deberían conectarse al servidor alojado en su lugar.

{
  "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, apunta a https://mcp.alchemy.com/mcp usando transporte HTTP Streamable.

Servidor STDIO Local

Legado: Esta sección documenta el servidor STDIO local de código abierto. No se mantiene activamente. Usa el servidor alojado a menos que necesites específicamente el paquete npm @alchemy/mcp-server o el flujo de trabajo de desarrollo local.

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

• Consultar precios de tokens e historial de precios (incluyendo consultas flexibles de rangos de tiempo)
• Obtener información de propiedad de NFTs y datos de contratos
• Ver el historial de transacciones en múltiples redes
• Consultar 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 un servidor de agente de wallet configurado)
• Ejecutar swaps de tokens mediante protocolos DEX (requiere un servidor de agente de wallet configurado)
• ¡Y más!

Configuración Rápida

Para configurar rápidamente el servidor MCP, usa la siguiente configuración en tu archivo de configuración MCP (normalmente en los ajustes 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 API de Alchemy (requerida para todas las consultas de datos blockchain)

Para la funcionalidad de transacciones y swaps, también debes configurar:

• AGENT_WALLET_SERVER - URL de un servidor de agente de wallet configurado que gestione las operaciones de Cuenta de Contrato Inteligente

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

Métodos Disponibles

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

Métodos de Precio de Tokens

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 mainnet 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 de tiempo 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 Multichain de Tokens

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: "Muéstrame las transacciones recientes de la wallet 0xdef...456 en Ethereum"

7. fetchTransfers

   • Obtiene datos detallados de transferencias de activos con opciones avanzadas de filtrado
   • Ejemplo: "Muéstrame todas las transferencias ERC-20 hacia o desde 0xghi...789"

Métodos NFT

8. fetchNftsOwnedByMultichainAddresses

   • Obtiene todos los NFTs propiedad de direcciones con filtrado de spam
   • Ejemplo: "¿Qué NFTs tiene 0xjkl...012?"

9. fetchNftContractDataByMultichainAddress

   • Obtiene datos de contratos 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 wallet configurado con la variable de entorno AGENT_WALLET_SERVER
    • Ejemplo: "Envía 0.1 ETH a 0xpqr...678"

Métodos de Swap

11. swap
    • Ejecuta swaps de tokens mediante protocolos DEX (Uniswap)
    • ⚠️ Importante: Requiere un servidor de agente de wallet configurado con la variable de entorno AGENT_WALLET_SERVER
    • Ejemplo: "Intercambia 100 USDC por ETH"

Desarrollo Local

Este repositorio sigue disponible como referencia y para migración, pero no se mantiene activamente. Para nuevas funciones y la cobertura de herramientas más reciente, usa el Alchemy MCP Server alojado.

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

Compilación para Producción

pnpm build

Uso del MCP Inspector para Depuración

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

pnpm inspector

Esto iniciará el MCP Inspector, al que podrás 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

Este repositorio no se mantiene activamente. Se pueden considerar pull requests para correcciones de seguridad o mejoras relacionadas con la migración, pero las nuevas funciones deberían dirigirse al servidor alojado. Para cambios importantes, abre primero un issue.

Licencia

Este servidor MCP está licenciado 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 más información sobre las APIs de Alchemy, consulta:

• Documentación de la API de Alchemy