返回 MCP 目录
public公开dns本地运行

mcp-server-bitcoin-wallet

一个基于MCP协议的比特币钱包服务器,支持AI代理通过指令查询地址、余额及发送交易。

article

README

🚀 基于模型上下文协议(MCP)的比特币钱包服务器

本项目是一个基于模型上下文协议(MCP)的比特币钱包服务器,它为AI代理与比特币钱包之间的交互搭建了桥梁,极大地拓展了比特币钱包的应用场景。

🚀 快速开始

本项目的搭建步骤如下:

  1. 安装依赖:
pnpm install
  1. 设置环境变量:
export WALLET_PASSWORD="你的安全密码"
  1. 构建项目:
pnpm build
  1. 运行服务器:
pnpm start

✨ 主要特性

  • get_address:显示一个用于接收付款的比特币地址
  • get_balance:显示当前钱包余额
  • send_transaction:向特定地址发送交易

📦 安装指南

开发模式运行

使用MCP CLI进行开发模式运行:

pnpm dev

检查模式运行

使用MCP Inspector运行:

pnpm inspect

🔧 技术细节

这是一个简单的比特币轻量级验证(SPV)钱包,具备以下特点:

  • 存储一个加密的私钥在操作系统密钥链中
  • 使用WALLET_PASSWORD环境变量提供的密码进行加密
  • 采用无状态就绪架构,所有网络数据按需获取

📄 许可证

文档未提及相关信息,暂不展示。

⚠️ 重要提示

  • 钱包密码必须通过环境变量提供
  • 私钥以加密形式存储在系统密钥链中
  • 切勿泄露敏感信息如私钥或助记词
  • 所有操作均在内存中进行,并在完成后清理
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端