使用说明

项目简介

Heurist Mesh MCP服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）客户端提供访问区块链和 Web3 领域工具的能力。它通过连接 Heurist Mesh API，将各种 Web3 智能代理和工具集成到 MCP 协议中，使得 LLM 能够安全、便捷地调用这些工具，扩展其在 Web3 应用场景中的能力。

主要功能点

Web3 工具集成: 提供丰富的区块链和 Web3 工具，例如加密货币数据查询、代币安全分析、交易对信息检索等。
Heurist Mesh 连接: 无缝连接 Heurist Mesh 开放网络，利用其预构建的 AI 代理和工具。
多种传输协议支持: 支持 SSE (Server-Sent Events) 和 stdio 两种传输协议，兼容不同的 MCP 客户端。
开箱即用: 提供预配置的工具集，并支持自定义配置，方便用户快速上手和灵活扩展。
API Key 统一管理: 使用单个 Heurist API Key 即可访问多个服务，简化了 API 管理。

安装步骤

前提条件

Python 3.10 或更高版本
推荐使用 UV 包管理器 (或者 Docker)
获取 Heurist API Key (可通过仓库提供的链接申请)

方法一：使用 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 .

服务器配置

1. Claude Desktop 配置 (stdio 传输)

将以下 JSON 配置添加到 Claude Desktop 的 'claude_desktop_config.json' 文件中的 'mcpServers' 字段。请根据实际情况修改路径和 API Key。

{
  "mcpServers": {
    "heurist-mesh-agent": {  // 服务器名称，可自定义
      "command": "uv",  // 启动命令，如果使用 Docker，则为 "docker"
      "args": [  // 命令参数
        "--directory",
        "/path/to/heurist-mesh-mcp-server/mesh_mcp_server",  //  **[请替换为仓库 mesh_mcp_server 目录的实际路径]**
        "run",
        "mesh-tool-server"
      ],
      "env": {  // 环境变量
        "HEURIST_API_KEY": "your-api-key-here"  // **[请替换为你的 Heurist API Key]**
      }
    }
  }
}

如果使用 Docker 运行 stdio 服务器，请使用以下配置：

{
  "mcpServers": {
    "mesh-agent": {  // 服务器名称，可自定义
      "command": "docker",  // 启动命令
      "args": [  // 命令参数
        "run",
        "--rm",
        "-i",
        "-e", "TRANSPORT=stdio",  //  指定使用 stdio 传输
        "-e", "HEURIST_API_KEY=your-api-key-here",  // **[请替换为你的 Heurist API Key]**
        "mesh-tool-server"
      ]
    }
  }
}

2. Cursor 配置 (SSE 传输)

在 Cursor 中添加 MCP Server URL。首先需要启动 SSE 服务器。

使用 UV 启动 SSE 服务器：

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

使用 Docker 启动 SSE 服务器：

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

启动服务器后，在 Cursor 的 MCP Server 设置中添加以下 URL：

http://0.0.0.0:8000/sse

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端（如 Claude Desktop 或 Cursor）中，即可通过自然语言指令调用 Heurist Mesh MCP 服务器提供的 Web3 工具。例如，你可以询问 "获取以太坊上最新热门代币的信息" 或 "查询 Solana 链上某个代币合约的安全详情"。LLM 会自动识别并调用相应的工具来完成你的请求。

更多可用工具及其参数，请参考仓库 README.md 文件中的 "Available tools" 表格。

关键词