Bitcoin MCP

🚀 Bitcoin MCP

一個為 AI 應用（如 Claude Desktop 和 Cursor）提供比特幣工具的 Model Context Protocol (MCP) 服務器，允許它們與比特幣網絡交互並管理錢包操作，極大提升了 AI 應用在比特幣相關場景的使用能力。

🚀 快速開始

Bitcoin MCP 服務器可擴展任何 MCP 客戶端的功能，使其能與比特幣網絡交互並管理錢包操作。

✨ 主要特性

• 創建和恢復 Bitcoin 和 Ark 錢包
• 發送 Bitcoin 和 Ark 交易
• 獲取 Bitcoin 和 Ark 錢包餘額
• 即時比特幣價格轉換
• 通過 blockchain.info 的緩存優化價格獲取
• 帶有強類型的錢包操作
• 全面的錯誤處理和備用方案
• 使用 Zod 進行模式驗證
• 集成 @arklabs/wallet-sdk

💻 使用示例

基礎用法

setup_wallet

創建或恢復一個比特幣錢包：

{
  action: "create" | "restore",
  privateKey?: string,
  network?: "bitcoin" | "testnet" | "signet" | "mutinynet",
  arkServerUrl?: string,
  esploraUrl?: string
}

send_bitcoin

向一個地址發送比特幣：

{
  address: string,
  amount: number, // 以聰為單位
  feeRate?: number // 可選費用率
}

高級用法

get_wallet_status

獲取當前錢包狀態和初始化狀態。

get_addresses

獲取所有錢包地址。

get_balance

獲取錢包餘額，可選 Fiat 貨幣轉換。

📦 安裝指南

該項目使用以下工具：

• pnpm - 包管理器
• Vite - 構建系統
• Vitest - 測試框架
• TypeScript - 編程語言
• Zod - 模式驗證

入門步驟

1. 安裝依賴：

pnpm install

2. 運行測試：

pnpm test

3. 構建項目：

pnpm build

📄 許可證

MIT License