Heurist Mesh MCP 服务器

连接 Heurist Mesh API 的模型上下文协议（MCP）服务器——通往 Web3 智能的网关。

Heurist Mesh 是 AI 智能体的技能市场。通用 AI 模型缺乏 Web3 领域的专业知识，往往无法提供准确结果。Heurist Mesh 提供 30 多个加密分析领域的专业 AI 智能体，为您的 AI 应用注入 Web3 专业能力。

功能特性

• Web3 智能网关：通过 MCP 协议访问 30+ 专业加密分析智能体
• AI 优化设计：专为 AI 优化的输入/输出格式——减少工具调用次数，降低 token 消耗
• 支持 SSE 和 stdio 两种传输协议
• 兼容 Claude、Cursor、Claude Desktop 等 MCP 接口
• 一个 API 密钥即可访问多项服务（CoinGecko、DexScreener、Twitter 分析等）

🔥 最新动态：定制智能体并创建按需管理的 MCP 服务器

您可以通过 Heurist Mesh 控制台 创建 SSE MCP 服务器。自由选择智能体，为您的任务组建专属集群！

托管式 SSE 端点

我们提供托管式 SSE 端点：https://mesh.heurist.xyz/mcp/sse。需要身份验证——您需要 Heurist API 密钥（使用邀请码 "claude" 可获取免费额度）。

可通过以下方式提供 API 密钥：

• X-HEURIST-API-KEY 请求头（推荐方式）
• Authorization: Bearer <your-api-key> 请求头
• api_key 查询参数

该端点包含推荐智能体的工具集，提供全面的 Web3 智能服务：

此为共享服务器，性能可能不稳定。生产环境建议自行托管或使用 Heurist Mesh 控制台 创建专属服务器。

Cursor 可直接访问 SSE 服务器。Claude Desktop 用户建议安装 mcp-proxy 连接 SSE 服务器。

环境要求

• Python 3.10 或更高版本
• UV 包管理器（推荐）
• 或 Docker 环境
• 获取 Heurist API 密钥 或使用邀请码 "claude" 领取免费 API 额度

安装指南

使用 UV（推荐方式）

# 克隆仓库
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# 安装依赖
uv pip install -e .

使用 Docker

# 克隆仓库
git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server

# 构建 Docker 镜像
docker build -t mesh-tool-server .

使用说明

方案一：使用 stdio 传输协议（适用于 Claude Desktop）

使用 UV

在 Claude Desktop 的 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "heurist-mesh-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/heurist-mesh-mcp-server/mesh_mcp_server",  // 修改为实际路径
        "run",
        "mesh-tool-server"
      ],
      "env": {
        "HEURIST_API_KEY": "your-api-key-here"  // 替换为您的 API 密钥
      }
    }
  }
}

使用 Docker

或在 claude_desktop_config.json 中使用 Docker 配置：

{
  "mcpServers": {
    "mesh-agent": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "TRANSPORT=stdio",
        "-e", "HEURIST_API_KEY=your-api-key-here",  // 替换为您的 API 密钥
        "mesh-tool-server"
      ]
    }
  }
}

将 /path/to/heurist-mesh-mcp-server 替换为实际仓库路径，your-api-key-here 替换为您的 Heurist API 密钥。

方案二：使用 SSE 传输协议（适用于 Cursor）

设置 .env 环境变量

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

使用 UV：

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

使用 Docker：

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

然后在 Cursor 中添加 MCP 服务器地址：http://0.0.0.0:8000/sse

可用工具

访问 https://mesh.heurist.ai/metadata.json 或 https://mesh.heurist.ai/console 查看全部 30+ 智能体及其工具。

推荐工具集

以下推荐智能体的工具可满足大多数 Web3 智能需求：

自定义智能体配置

服务器默认加载推荐智能体集合。修改配置方法：

1. 打开 server.py 文件找到 Config 类
2. 编辑 DEFAULT_AGENTS 列表（可参考 Heurist 元数据）

DEFAULT_AGENTS = [
    "TokenResolverAgent",        # 综合代币查询
    "TrendingTokenAgent",        # 聚合热门代币
    "TwitterIntelligenceAgent",  # Twitter/X 分析
    "ExaSearchDigestAgent",      # 附带摘要的网络搜索
    "FundingRateAgent",          # 币安资金费率数据
    "AIXBTProjectInfoAgent",     # 项目分析
    "ZerionWalletAnalysisAgent", # 钱包持仓分析
    # 按需添加更多智能体
]

许可协议

本 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。