Mesh Agent MCP Server

Heurist Mesh MCP 服务

一个连接 Heurist Mesh API 的 Model Context Protocol（MCP）服务——为你提供 Web3 智能能力。

Heurist Mesh 是面向 AI Agent 的技能市场。通用 AI 模型缺乏 Web3 专业知识，因此往往无法提供准确结果。Heurist Mesh 提供 30 多个专精于加密货币分析的 AI Agent，随时为你的 AI 应用提供所需的 Web3 专业能力。

功能

• Web3 智能入口：通过 MCP 访问 30 多个专精于加密货币分析的 Agent
• 针对 AI 优化：为 AI Agent 优化输入／输出格式，减少工具调用和 Token 用量
• 支持 SSE 和 stdio 传输
• 兼容 Claude、Cursor、Claude Desktop 和其他兼容 MCP 的接口
• 使用一个 API 密钥即可访问多项服务（CoinGecko、DexScreener、Twitter 分析等）

🔥 最新消息：自定义 Agent，按需创建托管 MCP 服务

你可以使用 Heurist Mesh Console 创建 SSE MCP 服务。选择 Agent 并组合成个性化的 Agent 群，以完成你的任务！

托管的 SSE 端点

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

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

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

此端点包含推荐 Agent 提供的工具，可全面获取 Web3 智能信息：

Agent	描述
TokenResolverAgent	根据地址／符号／名称查找代币，返回标准化资料和顶级 DEX 池
TrendingTokenAgent	汇总 GMGN、CoinGecko、Pump.fun、Dexscreener、Zora 和 Twitter 上的热门代币
TwitterIntelligenceAgent	Twitter/X 时间线、推文详情和智能搜索
ExaSearchDigestAgent	网页搜索并由大模型生成简明摘要
FundingRateAgent	Binance 资金费率、未平仓合约和现货－期货交易机会
AIXBTProjectInfoAgent	热门项目信息、基本面分析和市场摘要
ZerionWalletAnalysisAgent	分析 EVM 钱包中的代币和 NFT 持仓

这是一个共享服务，性能可能不稳定。用于生产环境时，我们建议自行托管，或使用 Heurist Mesh Console 创建专用服务。

Cursor 可直接访问 SSE 服务。对于 Claude Desktop 用户，我们建议安装 mcp-proxy 以连接 SSE 服务。

前置要求

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

安装

使用 UV（推荐）

# 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 .

使用 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 .

使用方法

选项 1：使用 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",  // Update this path
        "run",
        "mesh-tool-server"
      ],
      "env": {
        "HEURIST_API_KEY": "your-api-key-here"  // Update this key
      }
    }
  }
}

使用 Docker

或者，你可以在 Claude Desktop 中使用 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",  // Update this key
        "mesh-tool-server"
      ]
    }
  }
}

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

选项 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

可用工具

访问 https://mesh.heurist.ai/metadata.json 或 https://mesh.heurist.ai/console，查看所有 30 多个可用 Agent 及其工具。

推荐工具

以下推荐 Agent 提供的工具涵盖了大多数 Web3 情报用例：

工具名称	描述	Agent
token_search	按地址、符号、名称或 CoinGecko ID 查找代币	TokenResolverAgent
token_profile	获取包含市场数据、社交媒体信息和顶级池的完整代币资料	TokenResolverAgent
get_trending_tokens	汇总来自多个来源的热门代币	TrendingTokenAgent
get_market_summary	根据所有热门来源生成 AI 市场摘要	TrendingTokenAgent
twitter_search	智能搜索加密货币主题的 Twitter 内容	TwitterIntelligenceAgent
user_timeline	获取 Twitter 用户的近期推文	TwitterIntelligenceAgent
tweet_detail	获取指定推文的详细信息	TwitterIntelligenceAgent
exa_web_search	提供 AI 摘要的网页搜索	ExaSearchDigestAgent
exa_scrape_url	抓取并总结网页内容	ExaSearchDigestAgent
get_all_funding_rates	获取所有 Binance 永续合约的资金费率	FundingRateAgent
get_symbol_oi_and_funding	获取指定交易对的未平仓合约量和资金费率	FundingRateAgent
find_spot_futures_opportunities	查找现货与期货之间的套利机会	FundingRateAgent
search_projects	搜索热门项目并进行基本面分析	AIXBTProjectInfoAgent
get_market_summary	获取来自 AIXBT 的 AI 市场摘要	AIXBTProjectInfoAgent
fetch_wallet_tokens	获取 EVM 钱包中的代币持仓	ZerionWalletAnalysisAgent
fetch_wallet_nfts	获取 EVM 钱包中的 NFT 持仓	ZerionWalletAnalysisAgent

自定义支持的 Agent

此服务附带一组默认推荐 Agent。要修改可用的 Agent：

1. 打开 server.py 文件并找到 Config 类。
2. 编辑 DEFAULT_AGENTS 列表，以添加或移除 Heurist Metadata 中列出的 Agent。

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
]

许可证

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