Lightning MCP Server

🚀 雷電網絡 MCP 服務器

雷電網絡 MCP 服務器允許大型語言模型（LLM）代理（如運行在 Goose 中的那些）使用自然語言查詢雷電節點數據。它實現了 模型上下文協議 (MCP) 規範版本 2025-03-26，並與 MCP 檢查器 1.7.0 完全兼容。該服務器通過 gRPC 或 Lightning Node Connect (LNC) 連接到您的節點，能返回可讀的摘要和機器可讀的 JSON 輸出，且被設計為模塊化、可測試和可擴展的，以支持額外的節點類型，如 Core 雷電和 Eclair。有關架構細節，請參閱 ARCHITECTURE.md。

🚀 快速開始

連接到 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 服務器查詢我的雷電錢包餘額？"
• "請列出所有與我地址相關的通道。"

注意事項：

⚠️ 重要提示

• 目前不支持創建或修改頻道的操作。
• 查詢範圍僅限於您節點的本地數據。

📚 詳細文檔

兼容性

貢獻指南

有關設置、樣式和測試的指導，請參閱 CONTRIBUTING.md。

📄 許可證

Apache License 2.0。查看 LICENSE。