🚀 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