LND MCP Server

LND MCP Server

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

GitHub
Created Bypblittlepblittle

概述

LND MCP 服务器允许您通过自然语言接口与闪电网络节点进行交互，使 AI 助手可以安全地查询您的 LND 节点数据。兼容所有支持模型上下文协议的 LLM 应用程序。

安装

# 克隆仓库
git clone <repository-url>
cd lnd-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

LND 连接设置

您需要提供以下信息：

  • TLS 证书路径（通常在 ~/.lnd/tls.cert）
  • Macaroon 路径（推荐使用只读 macaroon）
  • LND 主机和端口（默认为 localhost:10009）

环境配置

创建环境文件（.env.development.local 或 .env.production.local）：

# LND 设置
LND_TLS_CERT_PATH=/path/to/your/tls.cert
LND_MACAROON_PATH=/path/to/your/readonly.macaroon
LND_HOST=localhost
LND_PORT=10009

# 或使用模拟 LND 进行测试
USE_MOCK_LND=true

运行服务器

# 开发模式
npm run mcp:dev

# 生产模式
npm run mcp:prod

# 使用模拟 LND（无需真实节点）
npm run mcp:mock

功能示例

服务器支持通过自然语言查询您的 LND 节点：

  • "显示我所有的通道"
  • "我的通道健康状况如何？"
  • "我的通道流动性是如何分布的？"

测试

# 运行完整测试套件
npm test

# 测试特定查询类型
node test/channel-queries/list.js
node test/channel-queries/health.js
node test/channel-queries/liquidity.js

使用 MCP 检查器测试

# 安装 MCP 检查器（如果尚未安装）
npm install -g @modelcontextprotocol/inspector

# 启动模拟服务器
node scripts/mock-server.js

# 另一个终端中运行检查器
npx @modelcontextprotocol/inspector

然后在 Web 界面中连接，将传输类型设置为"stdio"，命令设置为 scripts/mock-server.js 的路径。

环境管理

切换不同环境的便捷方式：

npm run mcp:dev    # 开发
npm run mcp:test   # 测试
npm run mcp:prod   # 生产

详细文档请参阅项目完整文档。