mcp-bitcoin-server

mcp-bitcoin-server

0
finance

The Bitcoin Wallet MCP Server is designed to facilitate interactions between AI agents and Bitcoin wallets. It provides functionalities for handling Bitcoin addresses, checking wallet balances, and sending transactions, with a focus on simplicity and security.

Bitcoin Wallet MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with a Bitcoin wallet.

Features

  • get_address: Display a Bitcoin address to receive a payment
  • get_balance: Display the current balance of the wallet
  • send_transaction: Send a transaction to a specific address

Setup

  1. Install dependencies:
pnpm install
  1. Set environment variables:
export WALLET_PASSWORD="your-secure-password"
  1. Build the project:
pnpm build
  1. Run the server:
pnpm start

Development

  • Run in development mode with the MCP CLI:
pnpm dev
  • Run with the MCP Inspector:
pnpm inspect

Architecture

This is a simple SPV (Simplified Payment Verification) Bitcoin wallet that:

  • Stores a single private key encrypted in the OS keychain
  • Uses the password from WALLET_PASSWORD env var for key encryption
  • Follows a stateless-ready architecture where all network data is fetched on-demand

Security Notes

  • The wallet password must be provided via environment variable
  • The private key is stored encrypted in the OS keychain
  • Never logs sensitive information like private keys or mnemonics
  • All operations are performed in memory and cleaned up after use