LND MCP Server

LND MCP Server

一种用于通过自然语言查询闪电网络（LND）节点数据的模型上下文协议（MCP）。

GitHub
Created Bypblittlepblittle

概述

LND MCP 服务器允许您通过自然语言查询闪电网络节点数据，返回人类可读的回答和结构化 JSON 数据。

安装

git clone https://github.com/pblittle/lnd-mcp-server.git
cd lnd-mcp-server
npm install
npm run build

运行服务器

选项 1：使用模拟数据（无需真实 LND 节点）

npm run mcp:mock

选项 2：连接到真实 LND 节点

  1. 配置环境变量：

    cp .env.example .env

# 编辑 .env 文件设置以下必要参数：
# LND_TLS_CERT_PATH=/path/to/your/tls.cert
# LND_MACAROON_PATH=/path/to/your/readonly.macaroon
# LND_HOST=localhost
# LND_PORT=10009
# USE_MOCK_LND=false

  2. 启动服务器：

    npm run mcp:prod

示例查询

  • 查看所有通道：显示我所有的通道
  • 检查通道健康：我的通道健康状况如何？
  • 了解流动性分布：我的通道流动性是如何分布的？

测试服务器

使用测试脚本

# 列出所有通道
node test/real-queries/list.js

# 检查通道健康状况
node test/real-queries/health.js

# 检查流动性分布
node test/real-queries/liquidity.js

使用 MCP Inspector

# 安装 MCP Inspector
npm install -g @modelcontextprotocol/inspector

# 启动检查器（确保服务器正在另一个终端运行）
npx @modelcontextprotocol/inspector

在 MCP Inspector 界面中：

  1. 点击 "Connect" 按钮
  2. 设置传输类型为 "stdio"
  3. 提供 scripts/mock-server.js 的路径
  4. 连接并开始提问

备注

  • 目前版本专注于通道数据，未来版本将添加更多 LND 数据类型
  • 兼容任何支持 MCP 的 LLM，如 Block Goose 和 Claude

更多详情请参阅 架构文档 和 贡献指南。