Uniswap Pools MCP

Uniswap Pools MCP

Um servidor MCP para consultar pools/pares Uniswap por endereço de token, entregando resultados limpos e estruturados para fácil integração e análise.

Recursos

• Consultar Pools/Pares Uniswap:
  • Buscar pools/pares V2, V3 e V4 para um determinado endereço de token.
  • Recuperar detalhes específicos de pool/par por versão (v2, v3, v4) e ID.
• Saída Formatada:
  • Retorna dados em tabelas markdown para consultas combinadas de pools.
  • Fornece resumos em texto markdown para consultas específicas de pool/par, incluindo endereços de token.

Instalação

Pré-requisitos

• Python: Versão 3.10 ou superior.
• uv: Um gerenciador de pacotes Python (recomendado para gerenciamento de dependências).
• Chave da API The Graph: Necessária para consultar Subgraphs. Obtenha uma em The Graph.

Configuração

1. Clonar o Repositório:

   git clone https://github.com/kukapay/uniswap-pools-mcp.git
   cd uniswap-pools-mcp
   

2. Instalar Dependências:

   uv sync
   

3. Instalar no Claude Desktop:

   Instale o servidor como um aplicativo do Claude Desktop:

   uv run mcp install main.py --name "Uniswap Pools"
   

   Arquivo de configuração como referência:

   {
      "mcpServers": {
          "Uniswap Pools": {
              "command": "uv",
              "args": [ "--directory", "/path/to/uniswap-pools-mcp", "run", "main.py" ],
              "env": { "THEGRAPH_API_KEY": "thegraph-api-key"}               
          }
      }
   }
   

   Substitua /path/to/uniswap-pools-mcp pelo seu caminho de instalação real e thegraph-api-key pela sua chave de API do The Graph.

Uso

O servidor fornece várias ferramentas para consultar dados de pools/pares Uniswap.

Ferramentas

1. Obter Todos os Pools/Pares para um Token:

   def get_token_pools(token_address: str) -> str:
   

   • Descrição: Consulta todos os pools/pares Uniswap V2, V3 e V4 para um determinado endereço de token.

   • Parâmetros:

     • token_address (str): Endereço Ethereum do token (ex.: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 para USDC).

   • Saída: Tabela markdown com colunas: Versão, ID, Par, Nível de Taxa, Volume USD, Liquidez/ReserveUSD, Taxas USD.

   • Exemplo:

     Prompt:

     Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
     

     Saída:

     | Version | ID                                         | Pair      | Fee Tier | Volume USD | Liquidity/ReserveUSD | Fees USD |
     |---------|--------------------------------------------|-----------|----------|------------|---------------------|----------|
     | v2      | 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc | USDC/WETH | 3000     | 2000000.0  | 500000.0            | N/A      |
     | v3      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 | USDC/WETH | 500      | 1000000.0  | 123456789           | 5000.0   |
     | v4      | 0x1234567890abcdef1234567890abcdef12345678 | USDC/WETH | 1000     | 500000.0   | 987654321           | 2500.0   |
     

2. Obter Pool/Par Específico por Versão e ID:

   def get_pool_data(version: str, pool_id: str) -> str:
   

   • Descrição: Consulta um pool/par Uniswap específico por versão (v2, v3 ou v4) e ID.

   • Parâmetros:

     • version (str): Versão Uniswap (v2, v3 ou v4).
     • pool_id (str): Endereço Ethereum do pool ou par (ex.: 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc).

   • Saída: Texto markdown com detalhes: Versão, ID, Par, Endereço Token0, Endereço Token1, Nível de Taxa, Volume USD, Liquidez/ReserveUSD, Taxas USD.

   • Exemplo:

     Prompt:

     Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
     

     Saída:

     **Uniswap V2 Pair Details**
     - **Version**: v2
     - **ID**: 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
     - **Pair**: USDC/WETH
     - **Token0 Address**: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
     - **Token1 Address**: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
     - **Fee Tier**: 3000 (0.3%)
     - **Volume USD**: 2000000.0
     - **Liquidity/ReserveUSD**: 500000.0
     - **Fees USD**: N/A
     

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para detalhes.