闪电网络 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 格式返回。它目前支持基本的通道查询，并正在积极发展以涵盖更广泛的节点状态、发票和路由数据。

示例查询

用自然语言询问：

Show me my channels

获得人类可读的响应：

Your node has 5 channels with a total capacity of 0.05000000 BTC (5,000,000 sats).
channels are active and 1 is inactive.

Your channels:
ACINQ: 0.02000000 BTC (2,000,000 sats) (active)
Bitrefill: 0.01000000 BTC (1,000,000 sats) (active)
LightningTipBot: 0.00800000 BTC (800,000 sats) (active)
Wallet of Satoshi: 0.00700000 BTC (700,000 sats) (active)
LN+: 0.00500000 BTC (500,000 sats) (inactive)

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

{
  "channels": [
    {
      "remote_alias": "ACINQ",
      "capacity": 2000000,
      "local_balance": 800000,
      "active": true
    },
    ...
  ],
  "summary": {
    "total_capacity": 5000000,
    "active_channels": 4,
    "inactive_channels": 1,
    "largest_channel_alias": "ACINQ",
    "average_local_balance": 750000
  }
}

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

支持的功能

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

“显示我的频道”

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

频道
“我的渠道健康状况如何？”
“我有哪些不活跃的频道吗？”
发票
“这周我收到了多少张发票？”
“我上次付款是多少？”
节点
“我最常连接到哪个节点？”
“我上次将付款转发到了哪个节点？”
路由
“过去 24 小时内我路由了多少？”
“哪些渠道承担着大部分的路由任务？”

快速入门

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

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

cp .env.example .env
# Configure .env with your LND credentials
npm run mcp:prod

通过 Tor 连接到 LND 节点

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

确保 Tor 已安装并正在您的系统上运行：
# macOS (using Homebrew) brew install tor brew services start tor # Ubuntu/Debian sudo apt install tor sudo systemctl start tor
使用 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
确保您的 TLS 证书为 PEM 格式（以-----BEGIN CERTIFICATE-----开头）。如果您拥有原始证书，可以使用 extract-credentials.js 脚本进行转换。

使用凭证提取工具

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

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

# Or set LNDCONNECT_URL in your .env file and run
node scripts/extract-credentials.js

该脚本将：

提取主机、端口、证书和 macaroon
将证书转换为 PEM 格式（正确连接所需）
将文件保存到 test/fixtures 目录
打印要添加到 .env 文件的配置

使用 MCP Inspector 进行测试

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

npm install -g @modelcontextprotocol/inspector
npm run build
LOG_LEVEL=warn npx @modelcontextprotocol/inspector node scripts/inspect.js

兼容性

MCP 规范版本2025-03-26
MCP 检查器版本1.7.0
MCP 剂兼容性（例如 Goose）
gRPC 支持直接节点访问
LNC 支持安全远程访问
JSON 和自然语言输出格式

贡献

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

执照

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

LND MCP Server

Integrations