Bitcoin & Lightning Network MCP Server

Bitcoin & Lightning Network MCP

This MCP server enables AI models to interact with Bitcoin and Lightning Network infrastructure, allowing them to perform various cryptocurrency operations directly.

Installation

You can install the Bitcoin & Lightning Network MCP in several ways depending on your preferred AI assistant platform.

Using with Claude Desktop

1. Download and install Claude Desktop from the official Anthropic website.

2. Configure Claude Desktop to use the Bitcoin MCP Server by editing the configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the following entry to the mcpServers section:

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}

4. Save the file and restart Claude Desktop.

Using with Goose

STDIO (Local Extension)

1. Install the MCP server:

npm install -g bitcoin-mcp

2. Configure Goose to use the Bitcoin MCP by adding it to your extensions:

goose extension add bitcoin-mcp

SSE (Remote Extension)

1. Start the MCP server:

npx bitcoin-mcp@latest

2. Add the server URL to Goose:

goose extension add http://localhost:3000/sse

Development Setup

If you want to run the server from source:

1. Clone the repository:

git clone https://github.com/AbdelStark/bitcoin-mcp.git
cd bitcoin-mcp

2. Install dependencies:

npm install

3. Create a .env file based on the example:

cp .env.example .env

4. Start the server:

npm start

Lightning Network Configuration (Optional)

To enable Lightning Network functionality:

1. Create an account on LNBits or set up your own LNBits instance.
2. Create a new wallet and obtain your admin key.
3. Add the following to your .env file:

LNBITS_ADMIN_KEY=your_admin_key
LNBITS_ENDPOINT=https://legend.lnbits.com

Docker Deployment

You can also run the MCP server using Docker:

docker build -t bitcoin-mcp .
docker run -p 3000:3000 bitcoin-mcp

Usage Examples

Once installed, you can ask your AI assistant to perform various Bitcoin and Lightning Network operations:

• "Generate a new Bitcoin key pair"
• "Validate this Bitcoin address: bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
• "Decode this Bitcoin transaction: 0200000001..."
• "Get information about the latest Bitcoin block"
• "Fetch details for transaction with TXID: 4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
• "Decode this Lightning invoice: lnbc..."
• "Pay this Lightning invoice: lnbc..."

The AI will use the appropriate tools from the MCP server to fulfill these requests.