satoshkin-aml-mcp

Satoshkin AML/KYT MCP サーバー

AML/KYT 暗号資産ウォレットスクリーニング用の MCP サーバーです。Claude Desktop、Claude Code、ChatGPT MCP クライアント、社内エージェントツールなどの AI クライアントを Satoshkin のウォレットリスクチェックに接続するために設計されています。

この MCP サーバーは、AML（アンチマネーロンダリング）および KYT（取引の把握）スクリーニング用の暗号資産コンプライアンスツールを AI アシスタントに提供します。Claude Desktop、Claude Code、および MCP 対応クライアントと互換性があります。

API キーを設定すると、リスクスコア 0～100、リスクレベル、資金源タグ、アクティビティの日付、取引量合計など、BitOK に基づく実データを返します。キーがない場合、サーバーはモックモードで動作することが明確に示されます。

ステータス

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 に公開されていません。公開 GitHub リポジトリを npx で使用してください。

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 バックエンド認証による API キーごとのレート制限と課金

次回の予定：取引相手とクラスターの分析、許可／レビュー／ブロックの判定。

収益モデル

MCP サーバーは無料のオープンソースコネクターです。

実際のチェックにはSatoshkin APIキーが必要です。課金はチェック成功ごと（$0.55、前払いキー残高から差し引かれます）で、各キーで最初に行う実際のチェックは無料です。また、60秒以内のキャッシュ済みチェックの再実行には課金されません。キーは現在、Satoshkinサポートから発行されています。セルフサービスダッシュボードは開発中です。モックモードは無料で、回数制限もありません。

関連するSatoshkin製品

• P2Pボット：https://satoshkin.com
• AML/KYT Telegramボット：https://t.me/SatoshkinKYTbot
• AML/KYTウェブアプリ：提供予定

ユースケース

• OTCデスク：P2P取引の決済前に、取引相手のウォレットをスクリーニングします
• コンプライアンス担当者：AI支援ワークフロー中に、ウォレットのリスクをすばやくチェックします
• 暗号資産ファンドマネージャー：AIエージェントを介して、制裁対象やミキサーへの関与リスクについてウォレットアドレスを審査します
• Web3開発者：Claude／ChatGPTを活用したdAppにAMLスクリーニングを追加します
• 暗号資産ジャーナリスト：AIの支援を受けて、ウォレットの履歴を調査します

REST APIではなくMCPを使う理由

従来のAML API（Chainalysis、Elliptic、TRM Labs）を利用するには、次のものが必要です。

• AIクライアントごとのカスタム連携
• 呼び出しを仲介するバックエンドインフラストラクチャ
• コンテキストに合わせた手動のプロンプトエンジニアリング

このMCP サーバーを使えば、どのAIアシスタントからでも、LLMが理解できる構造化された入出力で、ネイティブにAMLチェックを実行できます。一度インストールすれば、あらゆるAIツールで利用できます。

ロードマップ

• v0.1：モックチェックを備えたスキャフォールド
• v0.2：Satoshkinバックエンド経由の実際のBitOK連携（チェックごとの課金、初回チェック無料、キーなしでもモックモードを利用可能）
• v0.3：セルフサービスのキーダッシュボードとチャージ機能
• v0.4：追加のチェーン（Solana、BNB、Polygon）
• v0.5：タグ分類の拡充と制裁対象専用フラグ
• v0.6：クラスター分析とエンティティ帰属分析

ライセンス

MIT