Mesh Agent MCP 服务器

一个模型上下文协议 (MCP) 服务器，连接到 Heurist Mesh API，为 Claude 提供访问各种区块链和 web3 工具的能力。

Heurist Mesh 是一个开放的、由专门构建的 AI 代理和工具组成的网络，每个代理和工具都专注于特定的 web3 领域，例如区块链数据分析、智能合约安全、代币指标和区块链交互。我们正在积极发展 Heurist Mesh 生态系统，不断集成更多工具以扩展其功能。

特性

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

托管 SSE 端点（Alpha 发布）

我们提供了一个托管的 SSE 端点，地址为 https://sequencer-v2.heurist.xyz/mcp/sse。 这包括来自以下常用代理的所有工具：CoingeckoTokenInfoAgent、ElfaTwitterIntelligenceAgent、ExaSearchAgent、DexScreenerTokenInfoAgent、ZerionWalletAnalysisAgent。 这是一个共享服务器，性能可能不稳定。

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

前提条件

• 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 一起使用，请将以下内容添加到您的 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

或者，您可以使用 Docker 和 Claude Desktop，方法是将以下内容添加到您的 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"
      ]
    }
  }
}

将 /path/to/mesh-agent-mcp 替换为仓库的实际路径，并将 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

可用工具

工具名称	描述	代理	参数	必需参数
get_coingecko_id	按名称搜索代币以获取其 CoinGecko ID	CoinGeckoTokenInfoAgent	token_name (字符串): 要搜索的代币名称	token_name
get_token_info	使用 CoinGecko ID 获取详细的代币信息和市场数据（您不能使用代币地址或名称或符号）	CoinGeckoTokenInfoAgent	coingecko_id (字符串): 代币的 CoinGecko ID	coingecko_id
get_trending_coins	获取 CoinGecko 上当前热门的加密货币	CoinGeckoTokenInfoAgent	-	None
get_specific_pair_info	通过链和交易对地址在 DexScreener 上获取交易对信息	DexScreenerTokenInfoAgent	chain (字符串): 链标识符（例如，solana、bsc、ethereum、base）<br>pair_address (字符串): 要查找的交易对合约地址	chain, pair_address
get_token_pairs	通过链和代币地址在 DexScreener 上获取交易对	DexScreenerTokenInfoAgent	chain (字符串): 链标识符（例如，solana、bsc、ethereum、base）<br>token_address (字符串): 要查找所有交易对的代币合约地址	chain, token_address
get_token_profiles	从 DexScreener 获取最新代币的基本信息	DexScreenerTokenInfoAgent	-	None
search_pairs	通过代币名称、符号或地址在 DexScreener 上搜索交易对	DexScreenerTokenInfoAgent	search_term (字符串): 搜索词（代币名称、符号或地址）	search_term
get_trending_tokens	获取 Twitter 上当前热门的代币	ElfaTwitterIntelligenceAgent	time_window (字符串): 要分析的时间窗口	None
search_account	使用提及搜索和帐户统计信息分析 Twitter 帐户	ElfaTwitterIntelligenceAgent	username (字符串): 要分析的 Twitter 用户名（不带 @）<br>days_ago (整数): 回溯提及的天数<br>limit (整数): 提及结果的最大数量	username
search_mentions	在 Twitter 上搜索提及特定代币或主题的内容	ElfaTwitterIntelligenceAgent	keywords (数组): 要搜索的关键字列表<br>days_ago (整数): 回溯的天数<br>limit (整数): 结果的最大数量（最小：20）	keywords
answer	使用 Exa 的 answer API 获取问题的直接答案	ExaSearchAgent	question (字符串): 要回答的问题	question
search	搜索与查询相关的网页	ExaSearchAgent	search_term (字符串): 搜索词<br>limit (整数): 要返回的最大结果数（默认值：10）	search_term
search_and_answer	对查询执行搜索和回答操作	ExaSearchAgent	topic (字符串): 要搜索和回答的主题	topic
execute_search	通过读取网页执行网络搜索查询	FirecrawlSearchAgent	search_term (字符串): 要执行的搜索词	search_term
generate_queries	为可以扩展研究的主题生成相关的搜索查询	FirecrawlSearchAgent	topic (字符串): 要研究的主要主题<br>num_queries (整数): 要生成的查询数量	topic
fetch_security_details	获取区块链代币合约的安全详细信息	GoplusAnalysisAgent	contract_address (字符串): 代币合约地址<br>chain_id (['integer', 'string']): 区块链链 ID 或 Solana 代币的 'solana'。 支持的链：Ethereum (1), Optimism (10), Cronos (25), BSC (56), Gnosis (100), HECO (128), Polygon (137), Fantom (250), KCC (321), zkSync Era (324), ETHW (10001), FON (201022), Arbitrum (42161), Avalanche (43114), Linea Mainnet (59144), Base (8453), Tron (tron), Scroll (534352), opBNB (204), Mantle (5000), ZKFair (42766), Blast (81457), Manta Pacific (169), Berachain Artio Testnet (80085), Merlin (4200), Bitlayer Mainnet (200901), zkLink Nova (810180), X Layer Mainnet (196), Solana (solana)	contract_address

自定义支持的代理

服务器带有一组默认代理。 要修改哪些代理可用：

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

DEFAULT_AGENTS = [
    "CoinGeckoTokenInfoAgent",
    "DexScreenerTokenInfoAgent",
    "ElfaTwitterIntelligenceAgent",
    "ExaSearchAgent",
    "FirecrawlSearchAgent",
    "GoplusAnalysisAgent",
    # 在此处添加代理
    "NewAgent"
]

许可证

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