Heurist Mesh MCP Server 是一个 Model Context Protocol（MCP）服务器，用于连接 Heurist Mesh API，为 AI 应用接入 Web3 智能能力。Heurist Mesh 被描述为 AI 智能体的技能市场：通用 AI 模型缺乏 Web3 专业知识，往往难以给出准确结果，而 Heurist Mesh 提供 30 多个擅长加密分析的专业 AI 智能体，为 AI 应用补充所需的 Web3 专长。
主要能力方面，该服务器提供对 30 多个专业加密分析智能体的访问；输入输出格式针对 AI 智能体优化，可减少工具调用次数、降低 token 使用量；支持 SSE 和 stdio 两种传输方式；可与 Claude、Cursor、Claude Desktop 及其他兼容 MCP 的界面配合使用；并支持用一个 API 密钥访问多个服务，例如 CoinGecko、DexScreener、Twitter 分析等。此外，用户可通过 Heurist Mesh Console 创建 SSE MCP 服务器，选择智能体并组合成个性化的智能体集群。
使用方式上，项目要求 Python 3.10 或更高版本，推荐使用 UV 包管理器，并需要获取 Heurist API 密钥（可使用邀请码 "claude" 领取免费额度）。官方提供托管 SSE 端点 https://mesh.heurist.xyz/mcp/sse，需要认证，API 密钥可通过 X-HEURIST-API-KEY 请求头（推荐）、Authorization: Bearer <your-api-key> 请求头或 api_key 查询参数提供。该端点包含推荐智能体的工具，用于全面的 Web3 智能。官方说明这是共享服务器，性能可能不稳定；生产环境建议自托管，或使用 Heurist Mesh Console 创建专用服务器。Cursor 可直接访问 SSE 服务器；Claude Desktop 用户建议安装 mcp-proxy 连接 SSE 服务器。
安装与运行方面，使用 UV（推荐）时有两种方式：一是以 stdio 传输运行（用于 Claude Desktop），需在 claude_desktop_config.json 中添加配置，也可通过 Docker 配合 Claude Desktop 使用，需将 /path/to/heurist-mesh-mcp-server 替换为仓库实际路径，将 your-api-key-here 替换为 Heurist API 密钥；二是以 SSE 传输运行（用于 Cursor），随后在 Cursor 中添加 MCP 服务器 URL：http://0.0.0.0:8000/sse。
可用工具方面，可访问 https://mesh.heurist.ai/metadata.json 或 https://mesh.heurist.ai/console 查看全部 30 多个可用智能体及其工具。服务器自带一组默认的推荐智能体；如需修改可用智能体，可打开 server.py 文件，找到 Config 类，编辑 DEFAULT_AGENTS 列表，按 Heurist Metadata 中列出的智能体进行增删。
适用场景包括：为 AI 应用补充 Web3 与加密分析能力，覆盖区块链分析、智能合约审计、代币指标、DeFi 分析、NFT 估值和交易监控等方向；在 Claude、Cursor 等 MCP 兼容客户端中调用相关工具；以及通过 Console 按需组合专用智能体集群。
限制方面，官方指出托管 SSE 端点为共享服务器，性能可能不稳定，生产环境建议自托管或创建专用服务器；使用需要 Heurist API 密钥；运行环境要求 Python 3.10 或更高版本。该项目采用 MIT 许可证，可自由使用、修改和分发，但需遵守 MIT 许可证条款。
