Mesh Agent MCP Server

基本能力

产品定位

Heurist Mesh MCP Server 是一个连接 Heurist Mesh API 的 MCP 服务器，旨在为 Claude 提供访问区块链和 Web3 工具的能力。

核心功能

• 连接至 Heurist Mesh API
• 加载加密货币数据和 Web3 用例的工具
• 支持 SSE 和 stdio 传输
• 兼容 Cursor、Claude Desktop 和其他 MCP 兼容接口
• 使用单一 API 密钥访问多种服务（如 CoinGecko 加密货币市场数据、GoPlus 代币安全审查）

适用场景

• 区块链数据分析
• 智能合约安全审查
• 代币指标分析
• 区块链交互
• Web3 工具集成

工具列表

常见问题解答

• 如何获取 Heurist API 密钥？ 访问 Heurist API 密钥获取页面 或使用邀请码 "claude" 申请免费 API 积分。
• 如何修改支持的代理？ 编辑 server.py 文件中的 DEFAULT_AGENTS 列表，添加或删除 Heurist Metadata 中列出的代理。

使用教程

使用依赖

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

安装教程

使用 UV（推荐）

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

# 安装包
uv pip install -e .

使用 Docker

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

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

调试方式

选项 1：使用 stdio 传输运行（适用于 Claude Desktop）

使用 UV

在 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"  // 更新此密钥
      }
    }
  }
}

使用 Docker

在 claude_desktop_config.json 中添加以下内容：

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

选项 2：使用 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 服务器 URL：http://0.0.0.0:8000/sse

许可证

该项目遵循 MIT 开源许可条款。