基本能力
产品定位
Heurist Mesh MCP Server 是一个连接 Heurist Mesh API 的 MCP 服务器，旨在为 Claude 提供访问区块链和 Web3 工具的能力。
核心功能
- 连接至 Heurist Mesh API
- 加载加密货币数据和 Web3 用例的工具
- 支持 SSE 和 stdio 传输
- 兼容 Cursor、Claude Desktop 和其他 MCP 兼容接口
- 使用单一 API 密钥访问多种服务（如 CoinGecko 加密货币市场数据、GoPlus 代币安全审查）
适用场景
- 区块链数据分析
- 智能合约安全审查
- 代币指标分析
- 区块链交互
- Web3 工具集成
工具列表
| 工具名称 | 描述 | 代理 | 参数 | 必填参数 |
|-----------|-------------|-------|------------|----------------|
| get_coingecko_id | 通过代币名称搜索获取其 CoinGecko ID | CoinGeckoTokenInfoAgent | token_name (string): 要搜索的代币名称 | token_name |
| get_token_info | 使用 CoinGecko ID 获取详细的代币信息和市场数据 | CoinGeckoTokenInfoAgent | coingecko_id (string): 代币的 CoinGecko ID | coingecko_id |
| get_trending_coins | 获取 CoinGecko 上当前热门的加密货币 | CoinGeckoTokenInfoAgent | - | None |
| get_specific_pair_info | 通过链和交易对地址在 DexScreener 上获取交易对信息 | DexScreenerTokenInfoAgent | chain (string): 链标识符（如 solana, bsc, ethereum, base)
pair_address (string): 要查询的交易对合约地址 | chain, pair_address |
| get_token_pairs | 通过链和代币地址在 DexScreener 上获取交易对 | DexScreenerTokenInfoAgent | chain (string): 链标识符（如 solana, bsc, ethereum, base)
token_address (string): 要查询所有交易对的代币合约地址 | chain, token_address |
| get_token_profiles | 从 DexScreener 获取最新代币的基本信息 | DexScreenerTokenInfoAgent | - | None |
| search_pairs | 通过代币名称、符号或地址在 DexScreener 上搜索交易对 | DexScreenerTokenInfoAgent | search_term (string): 搜索词（代币名称、符号或地址） | search_term |
| get_trending_tokens | 获取 Twitter 上当前热门的代币 | ElfaTwitterIntelligenceAgent | time_window (string): 分析的时间窗口 | None |
| search_account | 通过提及搜索和账户统计信息分析 Twitter 账户 | ElfaTwitterIntelligenceAgent | username (string): 要分析的 Twitter 用户名（不带 @）
days_ago (integer): 提及回溯的天数
limit (integer): 提及结果的最大数量 | username |
| search_mentions | 在 Twitter 上搜索特定代币或主题的提及 | ElfaTwitterIntelligenceAgent | keywords (array): 要搜索的关键词列表
days_ago (integer): 回溯的天数
limit (integer): 结果的最大数量（最小：20） | keywords |
| answer | 使用 Exa 的答案 API 直接回答问题 | ExaSearchAgent | question (string): 要回答的问题 | question |
| search | 搜索与查询相关的网页 | ExaSearchAgent | search_term (string): 搜索词
limit (integer): 返回结果的最大数量（默认：10） | search_term |
| search_and_answer | 对查询执行搜索和回答操作 | ExaSearchAgent | topic (string): 要搜索和回答的主题 | topic |
| execute_search | 通过阅读网页执行网络搜索查询 | FirecrawlSearchAgent | search_term (string): 要执行的搜索词 | search_term |
| generate_queries | 为主题生成相关搜索查询以扩展研究 | FirecrawlSearchAgent | topic (string): 要研究的主要主题
num_queries (integer): 要生成的查询数量 | topic |
| fetch_security_details | 获取区块链代币合约的安全详细信息 | GoplusAnalysisAgent | contract_address (string): 代币合约地址
chain_id (['integer', 'string']): 区块链链 ID 或 'solana' 表示 Solana 代币 | contract_address |
常见问题解答
- 如何获取 Heurist API 密钥？
访问 Heurist API 密钥获取页面 或使用邀请码 "claude" 申请免费 API 积分。 - 如何修改支持的代理？
编辑server.py文件中的DEFAULT_AGENTS列表，添加或删除 Heurist Metadata 中列出的代理。
使用教程
使用依赖
- Python 3.10 或更高版本
- UV 包管理器（推荐）
- 或 Docker
- 获取 Heurist API 密钥 或使用邀请码 "claude" 申请免费 API 积分
安装教程
使用 UV（推荐）
```bash
克隆仓库
git clone https://github.com/yourusername/heurist-mesh-agent-mcp.git
cd heurist-mesh-agent-mcp
安装包
uv pip install -e .
```
使用 Docker
```bash
克隆仓库
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 中添加以下内容：
bash
{
"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 中添加以下内容：
bash
{
"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 中
bash
cp .env.example .env
HEURIST_API_KEY=your-api-key-here
使用 UV:
bash
uv run mesh-tool-server --transport sse --port 8000
使用 Docker:
bash
docker run -p 8000:8000 -e PORT=8000 mesh-tool-server
在 Cursor 中，添加 MCP 服务器 URL：http://0.0.0.0:8000/sse
