JinDaGe - bitcoin-mcp MCP Details

article

README

🚀 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 - 模式验证

入门步骤

安装依赖：

pnpm install

运行测试：

pnpm test

构建项目：

pnpm build

📄 许可证

MIT License

bitcoin-mcp