Pblittle Lightning MCP Server

Lightning Network MCP Server是一个允许LLM代理通过自然语言查询Lightning节点数据的服务，支持gRPC和LNC连接，提供自然语言和JSON格式的响应。

金融开发者工具 #闪电网络 #自然语言查询 #节点数据 #MCP协议 .TypeScript

评分 : 2分

下载量 : 49

更新时间 : 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。