MCP Server Lnd

🚀 Lightning Network MCP Server

The Lightning Network MCP Server enables Large Language Model (LLM) agents (such as those running in Goose) to query Lightning node data via natural language. It implements the Model Context Protocol (MCP) specification version 2025-03-26 and is fully compatible with MCP Checker 1.7.0.

This server connects to your node via gRPC or Lightning Node Connect (LNC) and returns both human-readable summaries and machine-readable JSON outputs. It is designed to be modular, testable, and extensible to support more types of nodes, such as Core Lightning and Eclair.

For architectural details, refer to ARCHITECTURE.md.

🚀 Quick Start

The Lightning Network MCP Server provides a seamless way for LLM agents to interact with Lightning nodes. It connects to your node using gRPC or LNC and offers both human - readable and machine - readable outputs.

✨ Features

The system parses natural language prompts, determines user intent, evaluates domain logic, and queries your Lightning node. Responses are returned in plain text and structured JSON. Currently, it supports basic channel queries, and more extensive features such as node status, invoices, and routing data are under active development.

💻 Usage Examples

Basic Usage

Ask a question in natural language:

显示我的频道

Get a human - readable response:

您的节点有 5 个频道，总容量为 0.05000000 BTC（5,000,000 sats）。
4 个频道是活动的，1 个是不活跃的。

您的频道：
- 频道 ID 1：连接到节点 A，容量 0.02 BTC
- 频道 ID 2：连接到节点 B，容量 0.03 BTC
- 频道 ID 3：连接到节点 C，容量 0.01 BTC
- 频道 ID 4：连接到节点 D，容量 0.01 BTC
- 频道 ID 5：连接到节点 E，容量 0.02 BTC

Get a JSON response:

{
  "channels": [
    {
      "id": "channel_id_1",
      "counterparty": "node_a",
      "capacity": "0.02 BTC"
    },
    {
      "id": "channel_id_2",
      "counterparty": "node_b",
      // The rest of the JSON content is omitted as it's incomplete in the original
    }
  ]
}