MistTrack MCP

MistTrack MCP 服务

MistTrack MCP 服务将 Claude Desktop 等 MCP 客户端连接到 MistTrack OpenAPI。它让 AI 助手能够查询区块链地址和交易的标签、余额、档案、交易对手、风险评分、恶意资金信号和资金流向追踪。

功能

• 检测常见链和代币格式的地址
• 地址标签、概览、档案、操作和交易对手分析
• 使用 MistTrack Risk Score V3.0 检查地址和交易哈希
• 基于 MistTrack 威胁情报检查恶意资金
• 递归进行多层交易调查
• 生成 MistTrack 仪表板和链上浏览器 URL
• 内置用于风险分析工作流的 MCP 资源和提示词

要求

• Node.js 18 或更高版本
• MistTrack API 密钥
• 支持 OpenAPI 访问的 MistTrack 套餐

从 MistTrack 仪表板获取 API 密钥：https://dashboard.misttrack.io/apikeys

安装

直接通过 npx 使用该软件包：

npx -y misttrack@latest --key YOUR_MISTTRACK_API_KEY

或全局安装：

npm install -g misttrack
misttrack --key YOUR_MISTTRACK_API_KEY

也可以通过环境变量提供 API 密钥：

export MISTTRACK_API_KEY=YOUR_MISTTRACK_API_KEY
npx -y misttrack@latest

Claude Desktop 配置

将服务添加到 Claude Desktop MCP 配置中：

{
  "mcpServers": {
    "misttrack": {
      "command": "npx",
      "args": [
        "-y",
        "misttrack@latest",
        "--key",
        "YOUR_MISTTRACK_API_KEY"
      ]
    }
  }
}

更改配置后，重启 Claude Desktop。

命令选项

选项	说明	默认值
-k, --key <key>	MistTrack API 密钥	MISTTRACK_API_KEY
-u, --base-url <url>	MistTrack API 基础 URL	https://openapi.misttrack.io
-r, --rate-limit <limit>	API 请求速率限制，单位为每秒请求数	1.0
-m, --max-retries <retries>	可重试 API 错误的最大重试次数	3
-d, --retry-delay <delay>	初始重试延迟，单位为秒	1.0
-b, --retry-backoff <backoff>	重试退避倍率	2.0

工具

以下工具名称是服务端 MCP 工具名称。某些客户端会在名称前加上服务前缀，例如 mcp_misttrack_get_risk_score。

工具	用途
detect_address_chain	根据地址检测可能的链和代币格式
get_address_labels	获取地址的 MistTrack 标签
get_address_overview	获取地址余额、交易统计信息和格式化概览
get_address_action	获取地址的交易操作分析
get_address_trace	获取地址档案、交互平台和威胁情报
get_address_counterparty	获取地址交易对手分析
check_malicious_funds	根据地址威胁情报检查恶意资金信号
get_risk_score	获取地址或交易哈希的 MistTrack Risk Score V3.0
get_dashboard_url	生成 MistTrack 仪表板 URL
get_chain_explorer_url	为地址或交易哈希生成区块链浏览器 URL
get_url_info	同时返回 MistTrack 仪表板和浏览器 URL
analyze_transactions_recursive	递归分析交易关系和资金流向路径

风险评分

get_risk_score 使用 MistTrack 官方的 GET /v3/risk_score 端点。

{
  coin: string;                       // Example: ETH, BTC, USDT-TRC20
  address?: string;                   // Provide either address or txid
  txid?: string;                      // Provide either txid or address
  direction?: 'deposit' | 'withdraw'; // Only used for txid queries, default: deposit
}

重要响应字段：

字段	说明
score	MistTrack 返回的风险评分
risk_level	Low、Moderate、High 或 Severe
detail_list	易于理解的风险指标
risk_detail	评分时使用的详细风险暴露记录
risk_detail[].hop_dic	查询目标与风险实体之间的资金流路径（按跳数划分）
address_label	查询地址对应的实体标签，或查询 txid 时的转出／转入地址标签
risk_report_url	MistTrack AML 风险报告 URL

风险级别指南：

级别	评分	建议操作
Severe	91-100	禁止提现和交易，并立即上报
High	71-90	保持高级别监控并开展深入调查
Moderate	31-70	实施中等程度的监督
Low	0-30	实施最低程度的监督

提示词示例：

Assess the ETH risk score for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.

Check the risk score for this ETH transaction hash using withdraw direction: [TX_HASH]

递归交易分析

analyze_transactions_recursive 构建紧凑的多层交易图，用于追踪资金。

{
  coin: string;
  address: string;
  max_depth?: number;                  // 1-3, default: 1
  start_timestamp?: number;
  end_timestamp?: number;
  transaction_type?: 'in' | 'out' | 'all';
}

它可以识别带标签的交易对手、重要风险实体、标签统计信息以及可追踪的资金流路径。

示例：

Analyze potential BTC fund flows for 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa with a depth of 2.

支持的币种

MistTrack 支持多种链和代币格式。常见示例包括：

• Ethereum：ETH、USDT-ERC20、USDC-ERC20、WETH-ERC20
• Bitcoin：BTC
• TRON：TRX、USDT-TRC20、USDC-TRC20
• BNB Smart Chain：BNB、USDT-BEP20、USDC-BEP20
• Polygon：POL-Polygon、USDT-Polygon、USDC-Polygon
• Avalanche：AVAX-Avalanche、USDT-Avalanche、USDC-Avalanche
• Arbitrum、Optimism、Base、zkSync、Merlin、Toncoin、Solana、Litecoin、Dogecoin、Bitcoin Cash、HashKey Chain 和 Sui

完整的最新列表请参阅 MistTrack 官方文档：https://docs.misttrack.io/openapi/overview

工作流示例

地址标签查询

Check the labels for this Ethereum address: [ETH_ADDRESS]

地址概览

Analyze the overview information for this Bitcoin address: [BTC_ADDRESS]

交易对手分析

Analyze the counterparties of this address: [ETH_ADDRESS]

交易所资金流追踪

Track fund flow between this address and exchanges with depth 2: [ETH_ADDRESS]

恶意资金检测

Check whether this address has malicious fund exposure: [ETH_ADDRESS]

本地开发

安装依赖：

npm install

构建 TypeScript：

npm run build

在本地运行：

npm run dev -- --key YOUR_MISTTRACK_API_KEY

官方文档

• MistTrack 文档：https://docs.misttrack.io/
• OpenAPI 概览：https://docs.misttrack.io/openapi/overview
• 风险评分 V3.0：https://docs.misttrack.io/api-endpoints/get-risk-score-v3