Mesh Agent MCP Server
Se conecta a las APIs de Heurist Mesh para proporcionar acceso a diversas herramientas de blockchain y web3.
Documentación
Servidor MCP de Heurist Mesh
Un servidor de Model Context Protocol (MCP) que se conecta a las APIs de Heurist Mesh: tu puerta de entrada a la inteligencia Web3.
Heurist Mesh es el mercado de habilidades para agentes de IA. Los modelos de IA de propósito general carecen de conocimiento especializado sobre Web3 y a menudo no logran entregar resultados precisos. Heurist Mesh proporciona más de 30 agentes de IA especializados que son expertos en análisis de criptomonedas, listos para brindar a tus aplicaciones de IA la experiencia Web3 que necesitan.
Características
- Puerta de entrada a la inteligencia Web3: Accede a más de 30 agentes especializados en análisis de criptomonedas a través de MCP
- Optimizado para IA: Formatos de entrada/salida optimizados para agentes de IA: menos llamadas a herramientas, menor uso de tokens
- Compatible con transportes SSE y stdio
- Funciona con Claude, Cursor, Claude Desktop y otras interfaces compatibles con MCP
- Usa una sola clave de API para acceder a múltiples servicios (CoinGecko, DexScreener, análisis de Twitter y más)
🔥 Novedad: Personaliza tus Agentes y Crea Servidores MCP Administrados Bajo Demanda
Puedes usar Heurist Mesh Console para crear servidores MCP SSE. ¡Selecciona tus agentes y compón un enjambre personalizado para tus tareas!
Endpoint SSE Alojado
Proporcionamos un endpoint SSE alojado en https://mesh.heurist.xyz/mcp/sse. Se requiere autenticación: necesitas una clave de API de Heurist (usa el código de invitación "claude" para créditos gratuitos).
Proporciona tu clave de API mediante:
- Cabecera
X-HEURIST-API-KEY(recomendado) - Cabecera
Authorization: Bearer <your-api-key> - Parámetro de consulta
api_key
Este endpoint incluye herramientas de agentes recomendados para una inteligencia Web3 integral:
| Agente | Descripción |
|---|---|
TokenResolverAgent | Encuentra tokens por dirección/símbolo/nombre, devuelve perfiles normalizados y los principales pools DEX |
TrendingTokenAgent | Agrega tokens en tendencia de GMGN, CoinGecko, Pump.fun, Dexscreener, Zora y Twitter |
TwitterIntelligenceAgent | Línea de tiempo de Twitter/X, detalle de tweets y búsqueda inteligente |
ExaSearchDigestAgent | Búsqueda web con resumen conciso mediante LLM |
FundingRateAgent | Tasas de financiación de Binance, interés abierto y oportunidades spot-futuros |
AIXBTProjectInfoAgent | Información de proyectos en tendencia, análisis fundamental y resumen de mercado |
ZerionWalletAnalysisAgent | Análisis de tenencias de tokens y NFTs en billeteras EVM |
Este es un servidor compartido y el rendimiento puede ser inestable. Para uso en producción, recomendamos autoalojar o usar Heurist Mesh Console para crear servidores dedicados.
Cursor puede acceder directamente a servidores SSE. Para usuarios de Claude Desktop, recomendamos instalar mcp-proxy para conectarse al servidor SSE.
Requisitos previos
- Python 3.10 o superior
- Gestor de paquetes UV (recomendado)
- O Docker
- Obtén una clave de API de Heurist o puedes reclamar créditos de API gratuitos con el código de invitación "claude"
Instalación
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
Opción 1: Ejecutar con transporte stdio (para Claude Desktop)
Usando UV
Para usar esto con Claude Desktop, agrega lo siguiente a tu 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, puedes usar Docker con Claude Desktop agregando esto a tu 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"
]
}
}
}
Reemplaza /path/to/heurist-mesh-mcp-server con la ruta real al repositorio y your-api-key-here con tu clave de API de Heurist.
Opción 2: Ejecutar con transporte SSE (para Cursor)
Configuración de variables de entorno en .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
Luego, en Cursor, agrega la URL del servidor MCP: http://0.0.0.0:8000/sse
Herramientas Disponibles
Visita https://mesh.heurist.ai/metadata.json o https://mesh.heurist.ai/console para ver todos los más de 30 agentes disponibles y sus herramientas.
Herramientas Recomendadas
Estas herramientas de nuestros agentes recomendados cubren la mayoría de los casos de uso de inteligencia Web3:
| Nombre de la Herramienta | Descripción | Agente |
|---|---|---|
| token_search | Encuentra tokens por dirección, símbolo, nombre o ID de CoinGecko | TokenResolverAgent |
| token_profile | Obtén un perfil completo del token con datos de mercado, redes sociales y los principales pools | TokenResolverAgent |
| get_trending_tokens | Tokens en tendencia agregados de múltiples fuentes | TrendingTokenAgent |
| get_market_summary | Resumen de mercado generado por IA en todas las fuentes de tendencias | TrendingTokenAgent |
| twitter_search | Búsqueda inteligente en Twitter para temas de criptomonedas | TwitterIntelligenceAgent |
| user_timeline | Obtén tweets recientes de un usuario de Twitter | TwitterIntelligenceAgent |
| tweet_detail | Obtén información detallada sobre un tweet específico | TwitterIntelligenceAgent |
| exa_web_search | Búsqueda web con resumen mediante IA | ExaSearchDigestAgent |
| exa_scrape_url | Extrae y resume contenido de páginas web | ExaSearchDigestAgent |
| get_all_funding_rates | Obtén tasas de financiación para todos los contratos perpetuos de Binance | FundingRateAgent |
| get_symbol_oi_and_funding | Obtén interés abierto y financiación para un símbolo específico | FundingRateAgent |
| find_spot_futures_opportunities | Encuentra oportunidades de arbitraje entre spot y futuros | FundingRateAgent |
| search_projects | Busca proyectos en tendencia con análisis fundamental | AIXBTProjectInfoAgent |
| get_market_summary | Obtén resumen de mercado de IA de AIXBT | AIXBTProjectInfoAgent |
| fetch_wallet_tokens | Obtén tenencias de tokens en billeteras EVM | ZerionWalletAnalysisAgent |
| fetch_wallet_nfts | Obtén tenencias de NFTs en billeteras EVM | ZerionWalletAnalysisAgent |
Personalización de Agentes Compatibles
El servidor viene con un conjunto predeterminado de agentes recomendados. Para modificar qué agentes están disponibles:
- Abre el archivo
server.pyy localiza la claseConfig. - Edita la lista
DEFAULT_AGENTSpara agregar o eliminar agentes listados en 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
]
Licencia
Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT.