bsl-agent-mcp

MCP-сервер, который позволяет ИИ-агенту (Claude Desktop, Claude Code или любому MCP-клиенту) управлять кошельком пользователя в тестовой сети Bitcoin-IPC: вносить L1 BTC в subnet1, отправлять wBTC внутри subnet1 или между subnet1 и subnet2, а также получать привязанную к 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 репозитория; блок env в конфигурации Desktop имеет приоритет.

Конфигурация

Примечания

• Суммы везде указаны в сатоши (1 BTC = 100 000 000 сатоши); у wBTC 18 знаков после запятой, и сервер конвертирует внутри.

• Получателями могут быть либо контакты из встроенной адресной книги, либо адреса, указанные пользователем; агенту предписано никогда не выдумывать адрес.