Mesh Agent MCP Server

Heurist Mesh MCP Server

Um servidor Model Context Protocol (MCP) que conecta às APIs do Heurist Mesh - seu gateway para inteligência Web3.

Heurist Mesh é o marketplace de habilidades para agentes de IA. Modelos de IA de propósito geral carecem de conhecimento especializado sobre Web3 e muitas vezes não entregam resultados precisos. O Heurist Mesh fornece 30+ agentes de IA especializados que são especialistas em análise de criptomoedas, prontos para dar às suas aplicações de IA a expertise Web3 que elas precisam.

Recursos

• Gateway para Inteligência Web3: Acesse 30+ agentes especializados em análise de criptomoedas via MCP
• Otimizado para IA: Formatos de entrada/saída otimizados para agentes de IA - menos chamadas de ferramentas, menos uso de tokens
• Suporta transportes SSE e stdio
• Funciona com Claude, Cursor, Claude Desktop e outras interfaces compatíveis com MCP
• Use uma chave de API para acessar vários serviços (CoinGecko, DexScreener, análises do Twitter e mais)

🔥 Novidade: Personalize Seus Agentes e Crie Servidores MCP Gerenciados Sob Demanda

Você pode usar o Heurist Mesh Console para criar servidores MCP SSE. Selecione seus agentes e componha um enxame personalizado para suas tarefas!

Endpoint SSE Hospedado

Fornecemos um endpoint SSE hospedado em https://mesh.heurist.xyz/mcp/sse. Autenticação é necessária - você precisa de uma chave de API Heurist (use o código de convite "claude" para créditos gratuitos).

Forneça sua chave de API via:

• Cabeçalho X-HEURIST-API-KEY (recomendado)
• Cabeçalho Authorization: Bearer <your-api-key>
• Parâmetro de consulta api_key

Este endpoint inclui ferramentas de agentes recomendados para inteligência Web3 abrangente:

Agente	Descrição
TokenResolverAgent	Encontre tokens por endereço/símbolo/nome, retorne perfis normalizados e principais pools DEX
TrendingTokenAgent	Agrega tokens em alta do GMGN, CoinGecko, Pump.fun, Dexscreener, Zora e Twitter
TwitterIntelligenceAgent	Linha do tempo do Twitter/X, detalhes de tweets e busca inteligente
ExaSearchDigestAgent	Busca na web com sumarização concisa via LLM
FundingRateAgent	Taxas de funding da Binance, juros em aberto e oportunidades spot-futuros
AIXBTProjectInfoAgent	Informações de projetos em alta, análise fundamental e resumo de mercado
ZerionWalletAnalysisAgent	Análise de holdings de tokens e NFTs de carteiras EVM

Este é um servidor compartilhado e o desempenho pode ser instável. Para uso em produção, recomendamos auto-hospedagem ou usar o Heurist Mesh Console para criar servidores dedicados.

O Cursor pode acessar servidores SSE diretamente. Para usuários do Claude Desktop, recomendamos instalar o mcp-proxy para conectar ao servidor SSE.

Pré-requisitos

• Python 3.10 ou superior
• Gerenciador de pacotes UV (recomendado)
• OU Docker
• Obtenha uma chave de API Heurist ou você pode solicitar créditos de API gratuitos com o código de convite "claude"

Instalação

Usando UV (Recomendado)

# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# Install the package
uv pip install -e .

Usando Docker

# Clone the repository
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# Build the Docker image
docker build -t mesh-tool-server .

Uso

Opção 1: Executar com Transporte stdio (para Claude Desktop)

Usando UV

Para usar com o Claude Desktop, adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "heurist-mesh-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/heurist-mesh-mcp-server/mesh_mcp_server",  // Update this path
        "run",
        "mesh-tool-server"
      ],
      "env": {
        "HEURIST_API_KEY": "your-api-key-here"  // Update this key
      }
    }
  }
}

Usando Docker

Alternativamente, você pode usar Docker com o Claude Desktop adicionando isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "mesh-agent": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "TRANSPORT=stdio",
        "-e", "HEURIST_API_KEY=your-api-key-here",  // Update this key
        "mesh-tool-server"
      ]
    }
  }
}

Substitua /path/to/heurist-mesh-mcp-server pelo caminho real do repositório e your-api-key-here pela sua chave de API Heurist.

Opção 2: Executar com Transporte SSE (para Cursor)

Configurando Variáveis de Ambiente no .env

cp .env.example .env
HEURIST_API_KEY=your-api-key-here

Usando UV:

uv run mesh-tool-server --transport sse --port 8000

Usando Docker:

docker run -p 8000:8000 -e PORT=8000 mesh-tool-server

Em seguida, no Cursor, adicione a URL do Servidor MCP: http://0.0.0.0:8000/sse

Ferramentas Disponíveis

Visite https://mesh.heurist.ai/metadata.json ou https://mesh.heurist.ai/console para ver todos os 30+ agentes disponíveis e suas ferramentas.

Ferramentas Recomendadas

Estas ferramentas dos nossos agentes recomendados cobrem a maioria dos casos de uso de inteligência Web3:

Nome da Ferramenta	Descrição	Agente
token_search	Encontre tokens por endereço, símbolo, nome ou ID do CoinGecko	TokenResolverAgent
token_profile	Obtenha perfil abrangente do token com dados de mercado, redes sociais e principais pools	TokenResolverAgent
get_trending_tokens	Tokens em alta agregados de múltiplas fontes	TrendingTokenAgent
get_market_summary	Resumo de mercado gerado por IA em todas as fontes de tendências	TrendingTokenAgent
twitter_search	Busca inteligente no Twitter para tópicos de cripto	TwitterIntelligenceAgent
user_timeline	Obtenha tweets recentes de um usuário do Twitter	TwitterIntelligenceAgent
tweet_detail	Obtenha informações detalhadas sobre um tweet específico	TwitterIntelligenceAgent
exa_web_search	Busca na web com sumarização por IA	ExaSearchDigestAgent
exa_scrape_url	Extraia e resuma conteúdo de páginas web	ExaSearchDigestAgent
get_all_funding_rates	Obtenha taxas de funding de todos os contratos perpétuos da Binance	FundingRateAgent
get_symbol_oi_and_funding	Obtenha juros em aberto e funding para um símbolo específico	FundingRateAgent
find_spot_futures_opportunities	Encontre oportunidades de arbitragem entre spot e futuros	FundingRateAgent
search_projects	Pesquise projetos em alta com análise fundamental	AIXBTProjectInfoAgent
get_market_summary	Obtenha resumo de mercado por IA do AIXBT	AIXBTProjectInfoAgent
fetch_wallet_tokens	Obtenha holdings de tokens de carteiras EVM	ZerionWalletAnalysisAgent
fetch_wallet_nfts	Obtenha holdings de NFTs de carteiras EVM	ZerionWalletAnalysisAgent

Personalizando Agentes Suportados

O servidor vem com um conjunto padrão de agentes recomendados. Para modificar quais agentes estão disponíveis:

1. Abra o arquivo server.py e localize a classe Config.
2. Edite a lista DEFAULT_AGENTS para adicionar ou remover agentes listados no Heurist Metadata

DEFAULT_AGENTS = [
    "TokenResolverAgent",        # Comprehensive token lookup
    "TrendingTokenAgent",        # Aggregated trending tokens
    "TwitterIntelligenceAgent",  # Twitter/X analytics
    "ExaSearchDigestAgent",      # Web search with summarization
    "FundingRateAgent",          # Binance funding & OI data
    "AIXBTProjectInfoAgent",     # Project analysis
    "ZerionWalletAnalysisAgent", # Wallet holdings
    # Add more agents as needed
]

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.