bsl-agent-mcp

MCP-Server, der es einem KI-Agenten (Claude Desktop, Claude Code oder einem beliebigen MCP-Client) ermöglicht, eine dem Benutzer gehörende Wallet im Bitcoin-IPC-Testnetz zu bedienen: L1-BTC in subnet1 einzahlen, wBTC innerhalb von subnet1 oder von subnet1 nach subnet2 bezahlen und die Bitcoin-verankerte Quittung für jede Zahlung abzurufen. Der Agent hält niemals Schlüssel – er kann nur Operationen anfordern; der Server signiert lokal und lehnt jede Einzahlung oder Zahlung über SPEND_CAP_SATS ab, bis der Benutzer sie ausdrücklich genehmigt (confirmed=true).

Haftungsausschluss: Dieser Code wurde nicht geprüft und ist nur für den Testnetz-Einsatz gedacht. Verwenden Sie ihn nicht mit Mainnet-Geldern oder Schlüsseln, die echten Wert kontrollieren.

Werkzeuge

Voraussetzungen

Ein laufender bsl-client-Container – das öffentliche Image ist ghcr.io/bitcoinscalinglabs/bsl-client:testnet – mit seiner Konfigurationsdatei bsl.env, die außerdem AGENT_PRIVATE_KEY enthalten muss (der EVM-Schlüssel, von dem der Server zahlt).

Mit Docker ausführen

Das Image läuft neben bsl-client und teilt dessen Netzwerk; der Entrypoint erzeugt die ipc-cli-Konfiguration, importiert AGENT_PRIVATE_KEY, führt Konnektivitätsprüfungen durch und bleibt im Leerlauf.

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 hängt MCP-Sitzungen an den laufenden Container an:

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

Aus dem Quellcode ausführen (Entwicklung)

Node.js ≥ 20. Der bsl-client-Container muss den Provider-Port veröffentlichen (-p 127.0.0.1:3030:3030) und den Agentenschlüssel einmal importiert haben:

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-Konfiguration: "command": "node", "args": ["/ABS/PATH/bsl-agent-mcp/dist/index.js"]. Die Konfiguration stammt aus der .env des Repositorys; ein env-Block in der Desktop-Konfiguration hat Vorrang.

Konfiguration

Hinweise

• Beträge sind überall in Satoshis (1 BTC = 100.000.000 sats); wBTC hat 18 Dezimalstellen und der Server rechnet intern um.

• Empfänger sind entweder Zahlungsempfänger aus dem integrierten Adressbuch oder vom Benutzer bereitgestellte Adressen; der Agent wird angewiesen, niemals eine Adresse zu erfinden.