bsl-agent-mcp

MCP 서버로, AI 에이전트(Claude Desktop, Claude Code 또는 모든 MCP 클라이언트)가 Bitcoin-IPC 테스트넷에서 사용자 소유 지갑을 운영할 수 있게 합니다: L1 BTC를 subnet1에 예치하고, subnet1 내에서 또는 subnet2로 wBTC를 결제하며, 모든 결제에 대해 Bitcoin 앵커 영수증을 가져옵니다. 에이전트는 키를 보유하지 않으며 — 작업을 요청만 할 수 있습니다; 서버는 로컬에서 서명하고 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 sats); wBTC는 소수점 18자리를 가지며 서버가 내부적으로 변환합니다.

• 수신자는 기본 제공 주소록의 수신자 또는 사용자가 제공한 주소입니다; 에이전트는 주소를 임의로 만들어 내지 않도록 지시받습니다.