Pblittle_lightning Mcp Server

🚀 闪电网络 MCP 服务器

闪电网络 MCP 服务器允许大型语言模型 (LLM) 代理（例如在 Goose 中运行的代理）通过自然语言查询闪电节点数据。它实现了 Model Context Protocol (MCP) 规范版本 2025-03-26，并与 MCP 检查器 1.7.0 完全兼容。该服务器通过 gRPC 或 Lightning Node Connect (LNC) 连接到您的节点，可返回可读的摘要和机器可读的 JSON 输出。其设计具有模块化、可测试和可扩展性，未来将支持更多类型的节点，如 Core Lightning 和 Eclair。

🚀 快速开始

基础启动步骤

1. 复制并配置 .env.example 文件。
2. 运行 npm run build 构建项目。
3. 使用 MCP 检查器测试服务器兼容性。

通过 Tor 连接 LND 节点

若要通过 Tor 连接到远程 LND 节点，请按以下步骤操作：

1. 安装并启动 Tor 服务。
2. 配置 socks-proxy 和 http-proxy 环境变量。
3. 在 .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。

兼容性说明