bsl-agent-mcp

MCP サーバーは、AIエージェント（Claude Desktop、Claude Code、または任意のMCPクライアント）が Bitcoin-IPC テストネット上でユーザー所有のウォレットを操作できるようにします: L1 BTC を subnet1 に入金し、subnet1 内または subnet2 をまたいで wBTC を支払い、任意の支払いの Bitcoin アンカー付きレシートを取得します。エージェントは鍵を保持しません — 操作を要求するのみです。サーバーはローカルで署名し、ユーザーが明示的に承認する（confirmed=true）まで SPEND_CAP_SATS を超える入金または支払いを拒否します。

免責事項: このコードは監査されておらず、テストネットでのみ使用することを想定しています。 メインネットの資金や実際の価値を制御する鍵には使用しないでください。

ツール

要件

実行中の bsl-client コンテナ（公開イメージは ghcr.io/bitcoinscalinglabs/bsl-client:testnet）と、その bsl.env 設定ファイルが必要です。このファイルには AGENT_PRIVATE_KEY（サーバーが支払いに使用するEVM鍵）も含まれている必要があります。

Docker での実行

イメージは bsl-client の隣で実行され、そのネットワークを共有します。エントリポイントは ipc-cli 設定を生成し、AGENT_PRIVATE_KEY をインポートし、接続チェックを実行して、アイドル状態になります。

docker build -t ghcr.io/bitcoinscalinglabs/bsl-agent-mcp:testnet .

docker run -d --env-file ./bsl.env \
  --network container:bsl-client \
  --name bsl-agent-mcp \
  ghcr.io/bitcoinscalinglabs/bsl-agent-mcp:testnet
docker logs bsl-agent-mcp   # should end with "bsl-agent-mcp ready"

Claude Desktop は、稼働中のコンテナに MCP セッションを接続します:

{
  "mcpServers": {
    "bsl-payments": {
      "command": "docker",
      "args": ["exec", "-i", "bsl-agent-mcp", "node", "/app/dist/index.js"]
    }
  }
}

ソースから実行（開発）

Node.js ≥ 20 が必要です。bsl-client コンテナはプロバイダーポート（-p 127.0.0.1:3030:3030）を公開し、エージェント鍵を一度インポートしておく必要があります:

docker exec bsl-client ipc-cli wallet import --wallet-type evm --private-key <key>

npm install && npm run build
cp .env.example .env        # fill in

Claude Desktop の設定: "command": "node"、"args": ["/ABS/PATH/bsl-agent-mcp/dist/index.js"]。設定はリポジトリの .env から取得されます。Desktop 設定内の env ブロックが優先されます。

設定

注記

• 金額はすべてサトシ単位です（1 BTC = 100,000,000 sats）。wBTCは18桁の小数を持ち、サーバーが内部で変換します。

• 受信者は、組み込みのアドレス帳の受取人か、ユーザーが指定したアドレスのいずれかです。エージェントはアドレスを勝手に作成しないよう指示されています。