satoshkin-aml-mcp

Satoshkin AML/KYT MCP 服务

用于 AML/KYT 加密货币钱包筛查的 MCP 服务。该服务旨在将 Claude Desktop、Claude Code、ChatGPT MCP 客户端等 AI 客户端以及内部 Agent 工具连接到 Satoshkin 钱包风险检查服务。

此 MCP 服务为 AI 助手提供用于 AML（反洗钱）和 KYT（了解你的交易）筛查的加密货币合规工具。兼容 Claude Desktop、Claude Code 和任何兼容 MCP 的客户端。

配置 API 密钥后，检查会返回由 BitOK 支持的真实数据：风险评分 0-100、风险等级、资金来源标签、活动日期和交易量总计。未配置密钥时，服务将以明确标注的模拟模式运行。

状态

设置 SATOSHKIN_API_KEY 后，v0.2.0 会通过 Satoshkin 后端（ POST /api-accounts/aml-check，BitOK 数据）执行真实的 AML/KYT 筛查。

未配置 API 密钥时，服务将以模拟模式运行：返回确定且明确标注的占位响应， 不会被误认为是真实判定。

此代码库不包含 BitOK 凭据、生产环境 AML/KYT 业务逻辑、用户数据或付费层级限制。这些内容属于私有后端服务。

可用工具

check_wallet_aml

检查加密货币钱包地址的 AML/KYT 风险。地址会在客户端按链格式进行校验， 之后才会消耗任何配额。

输入：

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "chain": "BTC"
}

支持的 chain 值：

• BTC
• ETH
• TRON
• USDT-ERC20
• USDT-TRC20

真实输出（设置了 SATOSHKIN_API_KEY 时）：

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "chain": "BTC",
  "checked_at": "2026-06-10T12:00:00.000Z",
  "risk_score": 17,
  "risk_level": "low",
  "tags": ["exchange"],
  "first_activity": "2021-01-01",
  "last_activity": "2026-06-01",
  "total_volume_in_usd": "1000.00",
  "total_volume_out_usd": "900.00",
  "source": "bitok",
  "cache_hit": false,
  "rate_limit": { "remaining": 999, "resets_at": "2026-06-10T13:00:00.000Z" },
  "balance": { "charged_usd": "0.55", "after_usd": "9.45" }
}

错误会以结构化的 isError 载荷返回，并包含机器可读代码： unauthorized、insufficient_balance、rate_limited、validation_error、 bitok_upstream_error、bitok_timeout、upstream_unreachable、 invalid_response、internal_error 和 http_<status>（后端错误正文中没有 error 字段时的备用代码）。每个错误载荷还包含 http_status 字段。

结果仅作为风险参考指标，不构成法律或合规建议。

配置

环境变量	默认值	用途
SATOSHKIN_API_KEY	(未设置 = 模拟模式)	Satoshkin 签发的 API 密钥 sk_live_* / sk_test_*
SATOSHKIN_API_BASE_URL	https://satoshkin.com	后端基础 URL（可覆盖为预发布环境）
SATOSHKIN_TIMEOUT_MS	30000	请求超时时间；首次检查可能需要几秒钟

Claude Desktop / Claude Code

此软件包尚未发布到 npm。请通过 npx 使用公开的 GitHub 仓库。

将以下内容添加到 MCP 设置中：

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "npx",
      "args": ["-y", "github:satoshkin-dev/satoshkin-aml-mcp"],
      "env": {
        "SATOSHKIN_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

省略 env 块即可在模拟模式下运行。

本地开发时，请使用构建后的入口点：

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "node",
      "args": ["/absolute/path/to/satoshkin-aml-mcp/dist/index.js"]
    }
  }
}

本地开发

git clone https://github.com/satoshkin-dev/satoshkin-aml-mcp.git
cd satoshkin-aml-mcp
npm install
npm run build
npm test

在本地运行服务：

npm run dev

运行构建后的服务：

npm run build
node dist/index.js

检查范围

v0.2 已发布的功能：

• 风险评分 0-100 + 风险等级（低 / 中 / 高）
• 资金来源标签
• 首次和最近活动日期
• 流入和流出总量（USD）
• 通过 Satoshkin 后端身份验证进行按密钥速率限制和计费

后续计划：交易对手方和集群分析，以及允许 / 审查 / 阻止决策。

盈利模式

该 MCP 服务是免费的开源连接器。

实际检查需要 Satoshkin API 密钥。按成功检查次数计费 （每次 $0.55，从预付密钥余额中扣除）；每个密钥的首次实际检查免费， 60 秒内缓存的重复检查不收费。目前可通过 Satoshkin support 申请密钥；自助服务控制面板正在开发中。模拟模式免费且不限制使用次数。

相关 Satoshkin 产品

• P2P 机器人：https://satoshkin.com
• AML/KYT Telegram 机器人：https://t.me/SatoshkinKYTbot
• AML/KYT Web 应用：计划中

使用场景

• OTC 柜台：在结算 P2P 交易前筛查交易对手方钱包
• 合规专员：在 AI 辅助工作流中快速检查钱包风险
• 加密基金经理：通过 AI Agent 审查钱包地址是否涉及制裁或混币器
• Web3 开发者：为 Claude/ChatGPT 驱动的 dApp 添加 AML 筛查
• 加密货币记者：借助 AI 调查钱包历史记录

为什么选择 MCP，而不是 REST API？

传统 AML API（Chainalysis、Elliptic、TRM Labs）需要：

• 针对每个 AI 客户端进行定制集成
• 用于转发调用的后端基础设施
• 手动编写提示词工程，以提供上下文

该 MCP 服务可让任何 AI 助手原生调用 AML 检查，并提供大模型能够理解的结构化输入和输出。只需安装一次，即可在所有 AI 工具中使用。

路线图

• v0.1：使用模拟检查搭建基础框架
• v0.2：通过 Satoshkin 后端集成真实 BitOK（按次计费、首次检查免费、无需密钥即可使用模拟模式）
• v0.3：自助式密钥控制面板 + 充值
• v0.4：支持其他链（Solana、BNB、Polygon）
• v0.5：更丰富的标签分类体系和针对制裁的标记
• v0.6：聚类分析和实体归属判定

许可证

MIT