Lightning MCP Server

🚀 雷电网络 MCP 服务器

雷电网络 MCP 服务器允许大型语言模型（LLM）代理，例如运行在 Goose 中的代理，使用自然语言查询雷电节点数据。它实现了 模型上下文协议 (MCP) 规范版本 2025-03-26，并与 MCP 检查器 1.7.0 完全兼容。该服务器通过 gRPC 或 Lightning Node Connect (LNC) 连接到您的节点，返回可读的摘要和机器可读的 JSON 输出。它采用模块化设计，具备可测试性和可扩展性，以支持额外的节点类型，如 Core 雷电和 Eclair。

🚀 快速开始

连接到 LND 节点

使用默认配置

在项目根目录下创建一个 .env 文件，并添加以下内容：

# 使用 gRPC 的直接连接（推荐）
LND_GRPC_HOST=127.0.0.1
LND_GRPC_PORT=10009
MACAROON_FILE=./macaroon.pem
CERTIFICATE_FILE=./cert.pem

# 或使用 LNC 的远程连接
LNC_SERVER_HOST=127.0.0.1
LNC_SERVER_PORT=8080

使用 credential 提取工具

如果您的设备支持 - lndconnect URL，请运行以下命令：

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

该脚本将：

1. 提取主机、端口、证书和 macaroon。
2. 将证书转换为 PEM 格式（所需格式）。
3. 保存文件到测试/fixtures 目录。
4. 输出需要添加到 .env 文件的配置。

测试 MCP 检查器

要使用官方 MCP 检查器进行测试：

1. 安装检查器：

npm install -g @modelcontextprotocol/inspector

2. 构建项目：

npm run build

3. 运行检查：

LOG_LEVEL=warn npx @modelcontextprotocol/inspector node scripts/inspect.js

✨ 主要特性

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

💻 使用示例

基础用法

用自然语言提问：

• "我该如何使用 MCP 服务器查询我的雷电钱包余额？"
• "请列出所有与我地址相关的通道。"

注意事项

⚠️ 重要提示

• 目前不支持创建或修改频道的操作。
• 查询范围仅限于您节点的本地数据。

📚 详细文档

兼容性

• MCP 规范版本 2025-03-26
• MCP 检查器版本 1.7.0
• 与 MCP 代理（如鹅）兼容
• 支持 gRPC 直接节点访问
• 支持 LNC 远程安全访问
• 提供 JSON 和自然语言输出格式

架构细节

有关架构细节，请参阅 ARCHITECTURE.md。

贡献指南

有关设置、样式和测试的指导，请参阅 CONTRIBUTING.md。

📄 许可证

Apache License 2.0。查看 LICENSE。