Lnd MCP Server

🚀 閃電網絡MCP服務器

閃電網絡MCP服務器允許大型語言模型（LLM）代理，例如運行在 Goose 中的代理，使用自然語言查詢閃電節點數據。它實現了 Model Context Protocol (MCP) 規範版本 2025-03-26，並且與MCP Inspector 1.7.0完全兼容。該服務器為用戶提供了便捷的方式來獲取閃電節點數據，無論是用於開發測試還是實際業務應用，都具有很高的實用價值。

🚀 快速開始

安裝依賴項

npm install @modelcontextprotocol/inspector grpcio

運行示例

# 使用默認配置運行服務器
node scripts/start.js

# 使用自定義配置文件運行
node scripts/start.js --config config.json

✨ 主要特性

• 自然語言查詢：該系統能夠解釋自然語言提示，確定用戶意圖，評估領域邏輯，並查詢您的閃電節點。響應以純文本和結構化JSON返回。
• 多連接方式：通過gRPC或Lightning Node Connect (LNC) 連接至您的節點，並返回易於閱讀的摘要和機器可讀的JSON輸出。
• 可擴展性：設計上具有模塊化、可測試性和可擴展性，以支持更多類型的節點，如Core Lightning和Eclair。
• 功能持續開發：當前支持基本的通道查詢，並正在積極開發更廣泛的功能，如節點狀態、發票和路由數據。

💻 使用示例

基礎用法

用自然語言提問：

顯示我的渠道

獲得人類可讀的響應：

您的節點有 5 個渠道，總容量為 0.05000000 BTC（5,000,000 sats）。
4 個渠道是活躍的，1 個是非活躍的。

您的渠道：
1. ACINQ：0.02000000 BTC（2,000,000 sats）（活躍）
2. Bitrefill：0.01000000 BTC（1,000,000 sats）（活躍）
3. 其他渠道...

結構化JSON響應：

{
  "channels": [
    {
      "id": "channel_id_1",
      "capacity": "0.02000000 BTC",
      "state": "active"
    },
    ...
  ]
}

📚 詳細文檔

配置指南

環境變量

設置以下環境變量以配置行為：

• PORT：指定服務器監聽的端口（默認值為 3000）
• LOG_LEVEL：指定日誌級別（可選，值為 'debug'、'info'、'warn'、'error'）

配置文件

創建一個 config.json 文件以自定義設置：

{
  "server": {
    "port": 3001,
    "host": "localhost"
  },
  "logging": {
    "level": "debug"
  }
}

架構細節

有關架構細節，請參見 ARCHITECTURE.md。

🔧 技術細節

該服務器實現了 Model Context Protocol (MCP) 規範版本 2025-03-26，並完全兼容MCP Inspector 1.7.0。它通過gRPC或Lightning Node Connect (LNC) 連接至您的節點，在設計上注重模塊化、可測試性和可擴展性，以支持更多類型的節點。

🤝 項目貢獻

貢獻代碼

1. 叉取倉庫：git clone https://github.com/yourusername/lightning-mcp-server.git
2. 創建功能分支：git checkout -b feature/new-feature
3. 提交更改：git commit -m "Add new functionality"
4. 推送至遠程倉庫並創建拉取請求。

貢獻文檔

• 修正翻譯錯誤或不準確的內容。
• 增加更多示例和使用場景說明。
• 更新技術規格以反映最新功能。

📄 許可證

項目採用 Apache License 2.0，詳細信息請參閱 LICENSE 文件。

⚠️ 重要提示

• 確保TLS證書的安全性，避免在不安全的網絡中傳輸敏感數據。
• 使用強密碼套件來增強通信安全性。
• 定期更新依賴項以防止已知漏洞的影響。