convez.ai
MCP Server
Sharmaz

micro-wallet

Sharmaz/micro-wallet

Ver no GitHub
InicialPluginScore · de 0 a 100

Wallet example using phoenixd node and AI + Phoenixd MCP Server

Instalação

$npx convez-ai Sharmaz/micro-wallet

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

micro-wallet

Voice-enabled Lightning wallet. Interact with your Phoenixd node in natural language: "Create a 100 sat invoice with description: midnight snacks".

Stack

Frontend (React 19 + Tailwind)  →  Backend (Express)  →  phoenixd-mcp-server  →  Phoenixd
        :5173                           :3000                                        :9740
  • Frontend — React 19, TypeScript, Vite, Tailwind CSS
  • Backend — Express, HTTP adapter for MCP tools
  • phoenixd-mcp-server — NPM package exposing Phoenixd tools via MCP
  • LLM — Ollama (local), Anthropic or OpenAI (cloud) — configurable via .env
  • Connectivity — Phoenixd and Ollama accessible via Tailscale

Requirements

  • Phoenixd running (local or via Tailscale)
  • Node.js 24+
  • Ollama, Anthropic API key, or OpenAI API key (at least one)

Configuration

Backend (backend/.env)

# Phoenixd (can be a Tailscale IP)
PHOENIX_PASSWORD=your_password
PHOENIXD_HOST=100.x.x.x
PHOENIXD_PORT=9740
PHOENIX_PROTOCOL=http

# LLM Provider: "ollama" | "openai" | "anthropic"
LLM_PROVIDER=ollama

# Ollama via Tailscale
LLM_BASE_URL=http://100.x.x.x:11434/v1
LLM_MODEL=llama3.2

# Cloud (only if LLM_PROVIDER is openai or anthropic)
OPENAI_API_KEY=
ANTHROPIC_API_KEY=

PORT=3000

Frontend (frontend/.env)

VITE_BASE_URL=http://localhost:3000

Installation

# Backend
cd backend && npm install

# Frontend
cd frontend && npm install

Running the project

# Terminal 1 — Backend
cd backend && npm run start

# Terminal 2 — Frontend
cd frontend && npm run dev

Frontend available at http://localhost:5173.

Development

Both frontend/ and backend/ share the same script interface:

npm run lint          # ESLint check
npm run lint:fix      # ESLint auto-fix
npm run test          # Vitest (single pass)
npm run test:watch    # Vitest watch mode
npm run test:coverage # Vitest with coverage

Available MCP Tools

ToolDescription
get-balanceWallet balance in satoshis
create-invoiceGenerate a BOLT11 invoice
create-offerGenerate a BOLT12 offer
pay-invoicePay an invoice
pay-offerPay an offer
pay-lightning-addressPay to a Lightning address
list-incoming-paymentsIncoming payment history
list-outgoing-paymentsOutgoing payment history
get-node-infoNode information
list-channelsLightning channels
decode-invoiceDecode a BOLT11 invoice
decode-offerDecode a BOLT12 offer

HTTP Endpoints

GET  /tool/get-balance       — Current balance
POST /tool/create-invoice    — Create an invoice
POST /chat                   — Chat with LLM (coming soon)

Roadmap

  • Express backend with phoenixd-mcp-server
  • Frontend displaying balance
  • ESLint + Vitest configured for frontend and backend
  • GitHub Actions CI (lint + tests)
  • Migrate to standard MCP Client
  • /chat endpoint with LLM + tool use
  • Chat UI in the frontend
  • Voice commands (Web Speech API)
Ver o original no GitHub

Relacionados