Transaction MCP Bandate

安全的MCP服务器和分类账集成

一个统一的Node.js应用程序来管理安全的多重签名事务。

设置

1. 克隆仓库并安装依赖项：

npm install

1. 配置环境变量：

cp .env.example .env

编辑 .env 并添加您的 SAFE_API_KEY。对于Telegram通知，还添加 TELEGRAM_BOT_TOKEN 和 ADMIN_TELEGRAM_CHAT_ID.

如何跑步

应用程序需要 两面旗帜：输入模式（如何决定交易）和确认模式（如何签名）。

输入模式

确认模式

npm脚本

npm run mcp:ledger      # AI agent decides via MCP, sign via Ledger
npm run mcp:telegram    # AI agent decides via MCP, review via Telegram
npm run dev:ledger      # You decide via CLI, sign via Ledger
npm run dev:telegram    # You decide via CLI, review via Telegram

或者直接运行：

node index.mjs --mcp --ledger
node index.mjs --dev --telegram

流动

随着 --ledger

Pending Safe tx
  → rules.yml evaluation (auto-approve / auto-reject / ask human)
  → Decision made (via MCP agent or CLI)
     → Approve → added to Ledger queue
     → Reject  → added to Ledger queue (as rejection tx)
  → Open Ledger UI at http://127.0.0.1:3847/ui
  → Connect Ledger hardware wallet → sign

随着 --telegram

Pending Safe tx
  → rules.yml evaluation
  → Decision made
     → Approve → added to Ledger queue
     → Reject  → sent to Telegram bot for human review
       → Override → approve and add to Ledger queue
       → Confirm reject → tx stays pending on-chain

MCP工具

MCP客户端配置

{
  "mcpServers": {
    "safe-agent": {
      "url": "http://127.0.0.1:3847/mcp"
    }
  }
}

通过ngrok曝光

ngrok http 3847

然后使用ngrok URL+ /mcp 作为您的MCP端点。

环境变量

配置

安全地址、链ID和其他常量位于 config.mjs.

文件