publicaml

PublicAML MCP 服务

在 Claude Desktop、Cursor 或任何其他 MCP 客户端中进行区块链 AML 筛查。 用日常语言询问某个地址，助手就会根据 PublicAML 进行检查：制裁名单、发行方冻结、沿交易图谱传播的风险、为该钱包提供资金的一方，以及与之交易的一方。

支持的链：bitcoin、ethereum、bsc、tron。

无需账户即可使用。API 密钥仅用于提高速率限制并解锁向前追踪功能。

安装

Claude Desktop，claude_desktop_config.json：

{
  "mcpServers": {
    "publicaml": {
      "command": "npx",
      "args": ["-y", "@publicaml/mcp-server"]
    }
  }
}

使用 API 密钥：

{
  "mcpServers": {
    "publicaml": {
      "command": "npx",
      "args": ["-y", "@publicaml/mcp-server"],
      "env": { "PUBLICAML_API_KEY": "your-key" }
    }
  }
}

Cursor 使用 .cursor/mcp.json 中的相同配置块。Claude Code：

claude mcp add publicaml -- npx -y @publicaml/mcp-server

工具

screen_address

风险级别和评分、制裁名单、Tether/Circle 冻结情况、地址类型（交易所、混币器、赌博、桥、个人钱包）及其风险来源。

chain 为可选参数。省略时，会筛查该地址格式支持的所有链，并为每个结果标注链名称：相同的 0x… 字符串在 ethereum、bsc 和 tron 上代表不同的钱包，因此绝不会在不提示的情况下猜测。

trace_funds

direction: "incoming" 会沿资金来源反向追踪，以回答“谁给这个钱包打了钱”，并在遇到已标记的实体时停止，不会继续追踪到交易所的其他客户。direction: "outgoing" 会沿最大的资金流向追踪，直到资金离开链上的匿名部分。向外追踪需要 API 密钥。

追踪过程有墙上时钟时间限制，因此会返回未完成的答案，而不是超时；答案也会说明是否未完成。

list_counterparties

一个工具回答三个问题。classify 会列出交易对手并说明各自类型（个人、交易场所、枢纽、存款地址、合约、铸造/销毁）。category 会回答“这个钱包是否接触过任何交易所 / 混币器 / 赌场”。check 会针对该钱包检查一组可疑地址。

解读答案

• sanctioned: true 本身就是需要阻止的事实，无论评分如何。
• 评分是 0-100 的风险读数，不代表资金占比；各部分按 MAX 组合，因此明细相加不会等于总分。
• 数据中不存在的地址会返回 NOT FOUND。这表示未知，并非安全。
• 列表按排名排列且有数量上限。PARTIAL 答案仅表示最低范围，并非完整清单。
• USD 数值仅涵盖有定价的代币，并可能因低流动性代币而虚高。请将其视为数量级估算。

这些是供人类决策参考的证据，而不是决策本身。

配置

变量	默认值	含义
PUBLICAML_API_KEY	none	提高匿名速率限制，并解锁向外追踪功能。
PUBLICAML_API_BASE	https://intelapi.publicaml.org	API 基础 URL。
PUBLICAML_TIMEOUT_MS	60000	每个请求的超时时间。
PUBLICAML_TRACE_CONTINUES	2	自动继续未完成的反向追踪的次数。

一键桌面安装

同一服务也以 MCPB 捆绑包形式分发，Claude Desktop 可通过双击安装，无需编辑 JSON。使用以下命令构建：

npm run build:mcpb

捆绑包会生成在 dist/ 中。版本、描述、许可证和工具列表均从 package.json 及服务自身的工具定义中读取，因此捆绑包不会与 npm 发行版出现偏差。

开发

npm install
npm test          # unit tests, no network
node scripts/live.mjs  # end-to-end against the live API

采用 MIT 许可证。API 文档：https://publicaml.org/api