闪电网络 MCP 服务器

闪电网络 MCP 服务器允许大型语言模型 (LLM) 代理（例如在Goose中运行的代理）使用自然语言查询闪电节点数据。它实现了模型上下文协议 (MCP)规范版本2025-03-26 ，并与 MCP Inspector 1.7.0 完全兼容。

该服务器使用 gRPC 或 Lightning Node Connect (LNC) 连接到您的节点，并返回可读摘要和机器可读的 JSON 输出。它采用模块化、可测试和可扩展的设计，以支持 Core Lightning 和 Eclair 等其他节点类型。

有关架构的详细信息，请参阅ARCHITECTURE.md 。

它的作用

该系统能够解析自然语言提示、确定用户意图、评估域逻辑并查询您的闪电节点。响应以纯语言和结构化 JSON 格式返回。它目前支持基本的通道查询，并正在积极发展以涵盖更广泛的节点状态、发票和路由数据。

Related MCP server: MCP Snapshot Server

示例查询

用自然语言询问：

获得人类可读的响应：

以及用于应用程序的结构化 JSON 数据：

JSON 输出提供了相同数据的结构化版本，并针对 LLM 代理、UI 层或下游应用程序的使用进行了优化。

支持的功能

目前系统支持基本频道查询：

• “显示我的频道”

以下领域正在开发更强大的查询：

• 频道
  “我的渠道健康状况如何？”
  “我有哪些不活跃的频道吗？”

• 发票
  “这周我收到了多少张发票？”
  “我上次付款是多少？”

• 节点
  “我最常连接到哪个节点？”
  “我上次将付款转发到了哪个节点？”

• 路由
  “过去 24 小时内我路由了多少？”
  “哪些渠道承担着大部分的路由任务？”

快速入门

这提供了使用真实节点的零配置开发体验。

使用真实节点运行（通过 gRPC 或 LNC 的 LND）

通过 Tor 连接到 LND 节点

要连接到作为 Tor 隐藏服务运行的 LND 节点：

1. 确保 Tor 已安装并正在您的系统上运行：

   # macOS (using Homebrew) brew install tor brew services start tor # Ubuntu/Debian sudo apt install tor sudo systemctl start tor

2. 使用 Tor SOCKS 代理设置配置您的.env文件：

   CONNECTION_TYPE=lnd-direct LND_HOST=your-node-address.onion LND_PORT=10009 LND_TLS_CERT_PATH=/path/to/tls.pem # Use PEM format for better compatibility LND_MACAROON_PATH=/path/to/admin.macaroon SOCKS_PROXY_HOST=localhost SOCKS_PROXY_PORT=9050

3. 确保您的 TLS 证书为 PEM 格式（以-----BEGIN CERTIFICATE-----开头）。如果您拥有原始证书，可以使用 extract-credentials.js 脚本进行转换。

使用凭证提取工具

如果您有 lndconnect URL（常用于移动应用程序），则可以使用以下方法提取凭据：

该脚本将：

• 提取主机、端口、证书和 macaroon

• 将证书转换为 PEM 格式（正确连接所需）

• 将文件保存到 test/fixtures 目录

• 打印要添加到 .env 文件的配置

使用 MCP Inspector 进行测试

要使用官方 MCP 检查器测试服务器：

兼容性

• MCP 规范版本2025-03-26

• MCP 检查器版本1.7.0

• MCP 剂兼容性（例如 Goose）

• gRPC 支持直接节点访问

• LNC 支持安全远程访问

• JSON 和自然语言输出格式

贡献

请参阅CONTRIBUTING.md了解设置、样式和测试指导。

执照

Apache 许可证 2.0。请参阅许可证。