TheGraph MCP Server

O que faz o “TheGraph” MCP Server?

O TheGraph MCP Server é uma camada de integração que conecta agentes de IA a dados de blockchain indexados pelo protocolo The Graph. Ele permite que sistemas de IA acessem, consultem e analisem informações de blockchain de forma eficiente, expondo dados de subgraphs por meio de ferramentas padronizadas MCP (Model Context Protocol). Ao permitir que assistentes obtenham esquemas de subgraphs e executem consultas GraphQL, o TheGraph MCP Server facilita fluxos de desenvolvimento envolvendo análise de blockchain, recuperação de dados on-chain e monitoramento de finanças descentralizadas (DeFi). Este servidor possibilita que desenvolvedores e agentes de IA obtenham dados estruturados de blockchain, realizem análises automatizadas e construam aplicações que interajam de maneira fluida com a rede de indexação descentralizada do The Graph.

Lista de Prompts

• Consultas de Esquema
  • Prompts para obter e exibir o esquema de um subgraph, como solicitar um esquema GraphQL legível ou entender a estrutura do modelo de dados.
• Consultas de Dados
  • Prompts para buscar dados específicos de um subgraph, como encontrar os principais tokens por volume de negociação, recuperar pares com alta liquidez ou listar eventos recentes de swap.
• Tarefas de Análise
  • Prompts para realizar análises sobre dados de blockchain, como analisar volumes de negociação de tokens específicos em determinados períodos.

Lista de Recursos

Não há recursos MCP explícitos documentados no repositório.

Lista de Ferramentas

• getSubgraphSchema
  • Busca o esquema de um subgraph especificado, permitindo que agentes de IA compreendam a estrutura e o formato dos dados de blockchain indexados pelo The Graph.
• querySubgraph
  • Executa consultas GraphQL em um subgraph designado, possibilitando a extração de conjuntos de dados personalizados e análises diretamente dos dados de blockchain indexados pelo The Graph.

Casos de Uso deste MCP Server

• Análise de Dados de Blockchain
  • Desenvolvedores e agentes de IA podem analisar dados on-chain, como volumes de negociação ou liquidez, para fornecer insights para plataformas DeFi ou bots de negociação.
• Exploração de Esquema para Desenvolvedores
  • Permite a rápida obtenção de esquemas de subgraph para compreensão dos modelos de dados, acelerando o desenvolvimento de aplicações integradas à blockchain.
• Monitoramento e Relatórios DeFi
  • Monitoramento automatizado de métricas financeiras (por exemplo, tokens mais negociados, eventos de swap) para exchanges descentralizadas e ativos usando consultas a subgraphs.
• Recuperação Personalizada de Dados
  • Facilita a extração de dados específicos de blockchain para pesquisas, dashboards ou análises em tempo real através da criação e execução de consultas GraphQL personalizadas.
• Assistentes de Blockchain com IA
  • Potencializa agentes capazes de responder perguntas ou automatizar tarefas baseadas em dados de blockchain, como alertas sobre transações incomuns ou geração de relatórios.

Como configurar

Windsurf

1. Pré-requisitos: Certifique-se de que Python 3.10+ e uv estão instalados.
2. Clone o repositório:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Edite o arquivo de configuração: Localize o arquivo de configuração do Windsurf (ex.: config.json).
4. Adicione o TheGraph MCP Server:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Salve e reinicie o Windsurf.
6. Verifique: Teste com um prompt de consulta de esquema ou dados.

Claude

1. Pré-requisitos: Python e uv instalados.
2. Clone o repositório:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Atualize as configurações MCP do Claude: Edite o arquivo de configuração do Claude.
4. Insira os detalhes do servidor:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Reinicie o Claude e teste a conectividade.

Cursor

1. Instale os pré-requisitos: Python 3.10+ e uv.
2. Clone o repositório:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Edite o arquivo de configuração MCP do Cursor.
4. Adicione o seguinte JSON:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Reinicie o Cursor e verifique executando uma consulta de teste.

Cline

1. Pré-requisitos: Certifique-se de que Python 3.10+ e uv estão disponíveis.
2. Clone o repositório:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Edite o arquivo de configuração do Cline.
4. Insira o seguinte na configuração MCP:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Reinicie o Cline e teste com um prompt.

Protegendo Chaves de API

• Armazene seu THEGRAPH_API_KEY como uma variável de ambiente.
• Exemplo de configuração:

  {
    "mcpServers": {
      "thegraph-mcp": {
        "command": "uv",
        "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
        "env": {
          "THEGRAPH_API_KEY": "${THEGRAPH_API_KEY}"
        }
      }
    }
  }
  

Como usar este MCP em fluxos

Usando o MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo do FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os dados do seu servidor MCP usando este formato JSON:

{
  "thegraph-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “thegraph-mcp” para o nome real do seu servidor MCP e de substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Nossa opinião

O TheGraph MCP Server oferece uma interface clara e duas ferramentas essenciais para interação com dados de blockchain indexados pelo The Graph. A documentação aborda configuração e segurança, mas carece de detalhes sobre recursos MCP explícitos, roots ou sampling. No geral, é direto e funcional para o uso proposto.

Nota: 7/10

Pontuação MCP