bsl-agent-mcp

MCP 服务器，允许 AI 代理（Claude Desktop、Claude Code 或任何 MCP 客户端）操作用户拥有的钱包在 Bitcoin-IPC 测试网上：将 L1 BTC 存入 subnet1，在 subnet1 内或跨到 subnet2 支付 wBTC，并获取任何支付的比特币锚定收据。代理从不持有密钥——它只能请求操作；服务器在本地签名，并拒绝任何超过 SPEND_CAP_SATS 的存款或支付，直到用户明确批准（confirmed=true）。

免责声明： 此代码未经审计，仅用于测试网使用。 请勿将其用于主网资金或控制真实价值的密钥。

工具

要求

一个正在运行的 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 聪）；wBTC 有 18 位小数，服务器会在内部转换。

• 收款人可以是内置地址簿中的收款人，也可以是用户提供的地址；代理被指示绝不能凭空编造地址。