Alchemy MCP Server

Alchemy MCP Server (Legado — Não Mantido Ativamente)

Este servidor de código aberto do Model Context Protocol (MCP) executa as APIs de blockchain da Alchemy localmente via STDIO. Novos usuários devem usar o servidor Alchemy MCP hospedado em vez disso.

Servidor MCP Remoto (Recomendado)

A maneira mais rápida de começar é conectar-se ao servidor remoto hospedado em https://mcp.alchemy.com/mcp. Ele autentica via OAuth — basta entrar com sua conta da Alchemy quando solicitado. Nenhuma chave de API ou instalação local é necessária.

Documentação completa: alchemy.com/docs/alchemy-mcp-server

Aviso de legado: O servidor Alchemy MCP hospedado em https://mcp.alchemy.com/mcp é o servidor MCP recomendado e mantido ativamente. Este repositório contém o servidor STDIO local legado, não é mantido ativamente e pode ficar defasado em relação à cobertura de ferramentas e ao comportamento do servidor hospedado. A Alchemy planeja descontinuar este repositório; novos usuários devem conectar-se ao servidor hospedado.

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

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

Para qualquer outro cliente compatível com MCP, aponte-o para https://mcp.alchemy.com/mcp usando transporte HTTP Streamable.

Servidor STDIO Local

Legado: Esta seção documenta o servidor STDIO local de código aberto. Ele não é mantido ativamente. Use o servidor hospedado a menos que você precise especificamente do pacote npm @alchemy/mcp-server ou do fluxo de trabalho de desenvolvimento local.

Este servidor MCP cria uma ponte entre agentes de IA e as APIs de blockchain da Alchemy, permitindo que os agentes:

• Consultem preços de tokens e histórico de preços (incluindo consultas flexíveis de período de tempo)
• Obtenham informações de propriedade de NFTs e dados de contratos
• Visualizem histórico de transações em múltiplas redes
• Verifiquem saldos de tokens em múltiplas redes de blockchain
• Recuperem transferências de ativos detalhadas com filtros
• Enviem transações via Smart Contract Accounts (requer servidor de agente de carteira configurado)
• Executem swaps de tokens via protocolos DEX (requer servidor de agente de carteira configurado)
• E muito mais!

Configuração Rápida

Para configurar rapidamente o servidor MCP, use a seguinte configuração no seu arquivo de configuração MCP (normalmente nas configurações do Claude Desktop ou Cursor):

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

Esta configuração permite que você use o servidor sem clonar manualmente o repositório.

Variáveis de Ambiente

O servidor MCP requer a seguinte variável de ambiente:

• ALCHEMY_API_KEY - Sua chave de API da Alchemy (necessária para todas as consultas de dados de blockchain)

Para funcionalidade de transações e swaps, você também deve configurar:

• AGENT_WALLET_SERVER - URL de um servidor de agente de carteira configurado que lida com operações de Smart Contract Account

⚠️ Importante: Os métodos sendTransaction e swap não funcionarão sem um servidor de agente de carteira configurado corretamente. Esses métodos exigem infraestrutura de carteira externa para lidar com a assinatura e transmissão de transações.

Métodos Disponíveis

Você pode solicitar ao seu agente de IA que use os seguintes métodos:

Métodos de Preço de Token

1. fetchTokenPriceBySymbol

   • Obtém dados de preço atual de tokens por símbolo
   • Exemplo: "Qual é o preço atual de ETH e BTC?"

2. fetchTokenPriceByAddress

   • Obtém dados de preço atual de tokens por endereço de contrato
   • Exemplo: "Qual é o preço do token no endereço 0x1234...5678 na mainnet da Ethereum?"

3. fetchTokenPriceHistoryBySymbol

   • Obtém dados históricos de preço de tokens com intervalos de datas específicos
   • Exemplo: "Mostre-me o histórico de preço do BTC de 1º de janeiro a 1º de fevereiro de 2023, com intervalos diários"

4. fetchTokenPriceHistoryByTimeFrame

   • Obtém dados históricos de preço usando períodos de tempo flexíveis ou linguagem natural
   • Exemplo: "Mostre-me o preço do ETH na última semana" ou "Obtenha o preço do BTC nos últimos 30 dias"

Métodos de Token Multichain

5. fetchTokensOwnedByMultichainAddresses
   • Obtém saldos de tokens para endereços em múltiplas redes
   • Exemplo: "Quais tokens 0xabc...123 possui na Ethereum e na Base?"

Métodos de Histórico de Transações

6. fetchAddressTransactionHistory

   • Obtém histórico de transações para endereços em múltiplas redes
   • Exemplo: "Mostre transações recentes para a carteira 0xdef...456 na Ethereum"

7. fetchTransfers

   • Obtém dados detalhados de transferência de ativos com opções avançadas de filtro
   • Exemplo: "Mostre-me todas as transferências ERC-20 de ou para 0xghi...789"

Métodos de NFT

8. fetchNftsOwnedByMultichainAddresses

   • Obtém todos os NFTs pertencentes a endereços com filtro de spam
   • Exemplo: "Quais NFTs 0xjkl...012 possui?"

9. fetchNftContractDataByMultichainAddress

   • Obtém dados de contrato de NFT para endereços
   • Exemplo: "De quais coleções de NFT 0xmno...345 possui tokens?"

Métodos de Transação

10. sendTransaction
    • Envia transações via Smart Contract Accounts
    • ⚠️ Importante: Requer um servidor de agente de carteira configurado com a variável de ambiente AGENT_WALLET_SERVER
    • Exemplo: "Envie 0,1 ETH para 0xpqr...678"

Métodos de Swap

11. swap
    • Executa swaps de tokens via protocolos DEX (Uniswap)
    • ⚠️ Importante: Requer um servidor de agente de carteira configurado com a variável de ambiente AGENT_WALLET_SERVER
    • Exemplo: "Troque 100 USDC por ETH"

Desenvolvimento Local

Este repositório permanece disponível para referência e migração, mas não é mantido ativamente. Para novos recursos e a cobertura de ferramentas mais recente, use o servidor Alchemy MCP hospedado.

Instalação

1. Clone o repositório

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

2. Instale as dependências

pnpm install

Desenvolvimento

pnpm watch

Compilação para Produção

pnpm build

Usando o MCP Inspector para Depuração

O MCP Inspector ajuda você a depurar seu servidor MCP fornecendo uma interface visual para testar seus métodos:

pnpm inspector

Isso iniciará o MCP Inspector, que você pode acessar no seu navegador. Ele permite que você:

• Veja todos os métodos disponíveis
• Teste métodos com diferentes parâmetros
• Visualize os dados de resposta
• Depure problemas com seu servidor MCP

Contribuindo

Este repositório não é mantido ativamente. Pull requests para correções de segurança ou melhorias relacionadas à migração podem ser considerados, mas novos recursos devem ter como alvo o servidor hospedado. Para mudanças importantes, abra uma issue primeiro.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT.

Exemplos de Prompts

Aqui estão alguns exemplos de prompts que você pode usar com seu 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?

Referência da API

Para mais informações sobre as APIs da Alchemy, consulte:

• Documentação da API da Alchemy