Pblittle Lightning MCP Server

Lightning Network MCP Server是一個允許LLM代理通過自然語言查詢Lightning節點數據的服務，支持gRPC和LNC連接，提供自然語言和JSON格式的響應。

金融開發者工具 #閃電網絡 #自然語言查詢 #節點數據 #MCP協議 .TypeScript

評分 : 2分

下載量 : 19

更新時間 : 2025-04-29

What is the Lightning Network MCP Server?

This server allows users to interact with their Lightning Network nodes using everyday language. It translates natural language queries into node operations and returns both human-readable summaries and structured JSON data for applications.

How to use the MCP Server?

Connect to your Lightning node (LND, Core Lightning or Eclair) via gRPC or Lightning Node Connect (LNC), then ask questions about your node's status, channels, invoices or routing in plain English.

Use Cases

Ideal for node operators who want simplified node monitoring, developers building Lightning applications, and researchers analyzing network data without deep technical knowledge of node APIs.

Key Features

Natural Language InterfaceQuery node data using conversational English instead of complex API commands

Dual Output FormatGet both human-readable summaries and machine-friendly JSON responses

Multi-Node SupportWorks with LND, Core Lightning and Eclair nodes (some implementations in progress)

Tor Hidden Service SupportSecure connections to nodes running as Tor hidden services

Pros and Cons

Advantages

No need to learn complex Lightning node APIs

Simplified node monitoring for non-technical users

Structured output integrates easily with other applications

Secure remote access via Lightning Node Connect

Limitations

Currently supports limited query types (expanding regularly)

Requires initial technical setup for node connection

Natural language processing may occasionally misinterpret complex queries

Getting Started

Install dependencies

Ensure Node.js and npm are installed on your system

Configure connection

Set up your node connection details in the .env file

Start the server

Launch the MCP server in production mode

Connect via MCP Inspector

Test your setup using the official inspector tool

Example Queries

Channel Status CheckQuickly view all channels and their operational status

Node ConnectivityIdentify your most connected peers

Routing AnalysisUnderstand your node's routing activity

Frequently Asked Questions

What Lightning node implementations are supported?

Is this safe to use with my mainnet node?

How do I connect to a node over Tor?

Can I use this without technical knowledge?

Additional Resources

Model Context Protocol Specification

Official MCP specification documentation

Goose Framework

LLM agent framework compatible with MCP

MCP Inspector GitHub

Tool for testing MCP server implementations

Lightning Node Connect Guide

Documentation for secure remote node connections

🚀 閃電網絡 MCP 服務器

閃電網絡 MCP 服務器允許大型語言模型 (LLM) 代理（例如在 Goose 中運行的代理）通過自然語言查詢閃電節點數據。它實現了 Model Context Protocol (MCP) 規範版本 2025-03-26，並與 MCP 檢查器 1.7.0 完全兼容。該服務器通過 gRPC 或 Lightning Node Connect (LNC) 連接到您的節點，可返回可讀的摘要和機器可讀的 JSON 輸出。其設計具有模塊化、可測試和可擴展性，未來將支持更多類型的節點，如 Core Lightning 和 Eclair。

🚀 快速開始

基礎啟動步驟

複製並配置 .env.example 文件。
運行 npm run build 構建項目。
使用 MCP 檢查器測試服務器兼容性。

通過 Tor 連接 LND 節點

若要通過 Tor 連接到遠程 LND 節點，請按以下步驟操作：

安裝並啟動 Tor 服務。
配置 socks-proxy 和 http-proxy 環境變量。
在 .env 文件中設置代理參數。

使用憑證提取工具

如果使用 lndconnect URL，可運行以下腳本提取證書和密鑰：

node scripts/extract-credentials.js "lndconnect://your-node.onion:10009?cert=BASE64CERT&macaroon=BASE64MACAROON"

此腳本會將證書轉換為 PEM 格式，並保存到 test/fixtures 目錄。

✨ 主要特性

該系統能夠解釋自然語言提示，確定用戶意圖，評估領域邏輯，並查詢您的閃電節點。響應以純文本和結構化 JSON 返回。目前支持基本頻道查詢，更多功能正在開發中。

📦 安裝指南

構建項目

運行 npm run build 來構建項目。

配置環境

複製並配置 .env.example 文件。

測試兼容性

使用 MCP 檢查器測試服務器兼容性。

💻 使用示例

憑證提取

node scripts/extract-credentials.js "lndconnect://your-node.onion:10009?cert=BASE64CERT&macaroon=BASE64MACAROON"

此腳本用於提取 lndconnect URL 中的證書和密鑰。

測試服務器

npm install -g @modelcontextprotocol/inspector
npm run build
LOG_LEVEL=warn npx @modelcontextprotocol/inspector node scripts/inspect.js

使用 MCP 檢查器驗證服務器。

📚 詳細文檔

有關架構細節，請參閱 ARCHITECTURE.md。請參閱 CONTRIBUTING.md 瞭解貢獻指南。

📄 許可證

本項目採用 Apache License 2.0 許可。查看 LICENSE 瞭解更多。

🔧 技術細節

該服務器實現了 Model Context Protocol (MCP) 規範版本 2025-03-26，並完全兼容 MCP 檢查器 1.7.0。它通過 gRPC 或 Lightning Node Connect (LNC) 連接到您的節點，並返回可讀的摘要和機器可讀的 JSON 輸出。其設計為模塊化、可測試和可擴展，以支持更多類型的節點，例如 Core Lightning 和 Eclair。