flow-mcp
This project is a Model Context Protocol server that facilitates interactions with the Flow EVM blockchain. It provides an abstraction over Ethereum RPC methods for seamless operations within the Flow EVM ecosystem, leveraging a structured interface to engage with blockchain functionalities.
Servidor MCP para Flow EVM
Um servidor Model Context Protocol (MCP) para interagir com a blockchain Flow EVM. Este servidor serve como uma ponte entre modelos de linguagem e a rede Flow EVM, permitindo consultas e interações com a blockchain de forma simplificada.
O que é Flow EVM?
Flow EVM é uma implementação da Máquina Virtual Ethereum (EVM) na blockchain Flow, permitindo compatibilidade com contratos inteligentes, ferramentas e bibliotecas do ecossistema Ethereum, enquanto aproveita a arquitetura escalonável e eficiente da Flow.
Recursos
flow_getNetworkInfo
: Retorna informações sobre a rede Flow EVM atualflow_getCode
: Obtém o código em um endereço específico da Flow EVMflow_chainId
: Retorna o ID da cadeia atual da rede Flow EVMflow_gasPrice
: Obtém o preço atual do gás na redeflow_getBalance
: Consulta o saldo de uma conta na Flow EVMflow_call
: Executa uma chamada de função sem criar uma transaçãoflow_getLogs
: Obtém logs com base em critérios de filtro específicosflow_sendRawTransaction
: Envia uma transação assinada para a redeflow_blockNumber
: Retorna o número do bloco mais recenteflow_checkCOA
: Verifica se um endereço é uma Conta Controlada por Cadence (COA)
Implementação
Este servidor MCP implementa uma camada de abstração sobre os métodos RPC padrão do Ethereum, adaptados para o ambiente Flow EVM. Internamente, o servidor faz chamadas para os métodos RPC Ethereum (eth_*
), mas expõe uma interface com nomenclatura Flow (flow_*
) para maior clareza e identificação com o ecossistema Flow.
A Flow EVM suporta a maioria dos métodos RPC do Ethereum, permitindo a interação com a rede Flow usando as mesmas ferramentas e padrões familiares do ecossistema Ethereum.
Redes Suportadas
- Flow EVM Mainnet (Chain ID: 747)
- Flow EVM Testnet (Chain ID: 545)
Uso
- Instale as dependências:
npm install
- Compile o projeto:
npx tsc
- Execute o servidor:
npm start
Exemplo de uso com Claude
Consulte o saldo de 0x76A56657d20f572872A81b75530c905fD9F845e5 na Flow EVM.
Claude poderá usar a ferramenta flow_getBalance
para obter esta informação.