chainanalyzer-mcp

chainanalyzer-mcp

ChainAnalyzer 的 MCP 服务 — 为 AI Agent 提供多链区块链 AML 风险分析。

扫描任意地址，支持 12 条链，均可直接使用 — Bitcoin、Ethereum、Polygon、BNB Smart Chain、Base、Arbitrum、Optimism、Avalanche、Solana、Kaia、TRON 和 XRP。包含 76+ 条检测规则、ML 异常评分和 Neo4j 图分析。

工具

工具	描述	价格
check_address_risk	对任意区块链地址进行 AML 风险评分	$1.00
sanctions_check	OFAC / FATF / JFSA 制裁筛查	$0.50
trace_transaction	使用 ML 异常检测追踪交易流向	$3.00
detect_coinjoin	检测 CoinJoin / 混币模式（Bitcoin）	$1.00
cluster_wallet	通过 Neo4j 图分析进行钱包聚类	$2.50
batch_screening	批量 AML 筛查（最多 50 个地址）	$5.00
bridge_flow_trace	多跳跨链取证追踪，包含 Solver 检测 + 相同意图关联（NEAR Intents / Wormhole / Stargate / Across / Synapse / Hop / deBridge）	$3.00

快速开始

Claude Desktop / Claude Code

添加到 MCP 配置中：

{
  "mcpServers": {
    "chainanalyzer-aml": {
      "command": "npx",
      "args": ["-y", "chainanalyzer-mcp"],
      "env": {
        "CHAINANALYZER_API_KEY": "tfk_your_api_key"
      }
    }
  }
}

从源代码构建

git clone https://github.com/rascal-3/chainanalyzer-mcp.git
cd chainanalyzer-mcp
npm install
npm start

Agent 技能与 Claude Code 插件

此代码库附带一个 Agent 技能，用于告知 Agent 何时使用这些工具、如何根据地址格式选择链、首先调用哪个工具，以及如何报告结果。任何可读取 SKILL.md 的 Agent 都可以使用（Claude Code、Cursor、Codex CLI、Gemini CLI、OpenClaw 等）。

Claude Code（插件：一步完成 MCP 服务和技能配置）

/plugin marketplace add rascal-3/chainanalyzer-mcp
/plugin install chainanalyzer-aml@chainanalyzer

在 shell 环境中设置 CHAINANALYZER_API_KEY（或设置 X402_PRIVATE_KEY 以按请求付费）。插件的 .mcp.json 会从中读取该变量。

其他 Agent

将 skills/chainanalyzer-aml/ 复制到 Agent 的技能目录，并按照“快速开始”中的说明配置 MCP 服务。

MCP 注册表

已列入官方 MCP 注册表，名称为 io.github.rascal-3/chainanalyzer-mcp。

身份验证

选择以下三种模式之一：

1. API 密钥（所有套餐均可使用，包括 Free）

在 chain-analyzer.com → Account → Settings → API Keys 中创建 tfk_ API 密钥。所有套餐都可以创建密钥；Free 套餐每月包含 10 次扫描，可在付费前试用制裁筛查、风险分析、交易追踪、CoinJoin 和聚类功能。API 密钥模式下，batch_screening 需要 Starter 或更高套餐，bridge_flow_trace 需要 Business 或更高套餐（x402 模式没有套餐限制）。各套餐的速率限制：Free 每分钟 10 次，Starter 每分钟 30 次，Pro 每分钟 60 次，Business 每分钟 120 次，Enterprise 每分钟 300 次。

{
  "env": {
    "CHAINANALYZER_API_KEY": "tfk_your_api_key"
  }
}

2. x402 USDC 支付（按请求付费）

无需账户。每次请求使用 Base 或 Solana 上的 USDC 付款。

{
  "env": {
    "X402_PRIVATE_KEY": "your_wallet_private_key",
    "X402_NETWORK": "base"
  }
}

需要 x402 npm 包：npm install x402

3. 开发模式

无需身份验证。当 ChainAnalyzer 服务设置为 X402_ENABLED=false 时即可使用。

{
  "env": {
    "CHAINANALYZER_BASE_URL": "http://localhost:3000"
  }
}

环境变量

变量	描述	必需
CHAINANALYZER_API_KEY	tfk_ API 密钥（任何套餐均可，包括 Free）	API 密钥或 x402 二选一
X402_PRIVATE_KEY	用于 USDC 支付的钱包私钥	API 密钥或 x402 二选一
X402_NETWORK	支付网络：base 或 solana（默认值：base）	否
CHAINANALYZER_BASE_URL	API 基础 URL（默认值：https://chain-analyzer.com）	否

使用示例

配置完成后，向 AI Agent 提问：

“检查这个 Ethereum 地址是否受到制裁：0x1234...”

“分析这个 Solana 钱包的风险评分：ABC123...”

“追踪这笔 Bitcoin 交易的资金流向，并检查是否存在混币模式”

“对这 20 个地址进行 AML 合规筛查”

Agent 将自动调用相应的 ChainAnalyzer 工具。

支持的链

所有 12 条链均已向自助计划开放。

链	亮点
Bitcoin	OFAC 筛查、粉尘攻击、剥离链、CoinJoin 检测
Ethereum	18+ 个检测器、Neo4j 图分析、制裁筛查、混币器
Polygon / BNB Smart Chain / Base / Arbitrum / Optimism / Avalanche / Kaia	完整的 EVM AML 套件、跨链桥追踪
Solana	代币安全（rug pull、蜜罐）、钱包清空器检测、跨链桥追踪
TRON	USDT 流向筛查、制裁筛查（独立扫描器）
XRP	交易所 / 发行方标签、制裁筛查（独立扫描器）

bridge_flow_trace 支持 EVM 链、Solana 和 Kaia。detect_coinjoin 仅支持 Bitcoin。

链接

• ChainAnalyzer — Web 平台
• 通过 AI Agent 使用 ChainAnalyzer — 技能、插件和 MCP 设置指南
• API 参考
• x402 Protocol — 按请求付费标准

许可证

MIT - 参见 LICENSE

---

由 refinancier, inc. 构建