AI导哈

比特币闪电网络测试环境管理服务器

Polar MCP Server是一个用于管理比特币闪电网络测试环境的服务器，支持动态工具发现、实时UI更新和多种网络操作。

  • by jamaljsr
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 jamaljsr/polar-mcp

使用说明

Polar MCP服务器

模型上下文协议（MCP）服务器 极地闪电该服务器使Claude等AI助手能够与Polar交互，以管理比特币闪电网络测试环境。

什么是MCP？

这 模型上下文协议 是一个开放标准，使人工智能助手能够安全地连接到外部数据源和工具。MCP服务器公开了LLM可以动态发现和使用的功能。

特性

  • 动态工具发现：工具在Polar应用程序中定义并在运行时发现，确保MCP服务器与所有Polar版本保持兼容
  • 实时UI更新：通过MCP服务器所做的所有更改都会立即反映在Polar UI中
  • 网络管理：使用比特币和闪电节点创建、启动、停止和管理完整的闪电网络测试环境
  • 比特币操作：挖掘区块、发送交易、检查钱包余额和监控区块链状态
  • 闪电网络：打开和关闭渠道，创建和支付发票，管理节点钱包，监控网络健康状况
  • Taproot资产：生成、发送和管理Taproot资产，完全支持资产地址和全局同步
  • 资产渠道：使用Taproot资产为闪电通道提供资金，并创建资产支持的支付流
  • 避雷终端：管理LNC会话并创建资产支持的Lightning发票
  • 节点管理：添加、删除、启动、停止和配置单个节点（LND、c-lighting、Eclair、litd、tapd、比特币）
  • 导入/导出：使用ZIP文件导入/导出备份和还原网络配置

先决条件

  • 极地 必须安装并运行
  • Node.js 18或更高版本

安装

选项1：使用npx（推荐）

无需安装！将以下配置添加到MCP客户端。

选项2：全局安装

yarn global add @lightningpolar/mcp

配置

克劳德桌面

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "polar": {
      "command": "npx",
      "args": ["-y", "@lightningpolar/mcp"]
    }
  }
}

或者，如果您是全局安装的：

{
  "mcpServers": {
    "polar": {
      "command": "polar-mcp"
    }
  }
}

其他MCP客户端

服务器使用stdio传输并遵循MCP规范。它应该适用于任何兼容MCP的客户端。有关配置说明，请参阅客户的文档。

用法

  1. 启动Polar：启动Polar应用程序
  2. 启动您的AI助手：打开克劳德桌面（或您的MCP客户端）
  3. 提出问题：AI现在可以与Polar进行交互

示例提示

网络管理：

  • “列出我在极地的所有闪电网络”
  • “创建一个名为“测试网络”的新Lightning网络，其中包含2个LND节点和1个Taproot Assets节点”
  • “启动网络1”
  • “停止所有正在运行的网络”

比特币操作：

  • “在网络1上挖掘10个区块”
  • “获取网络1的区块链信息”
  • “在网络1上从alice向bob发送0.1 BTC”

闪电通道：

  • “在网络1上打开一个从alice到bob的频道，播放1000000次sat”
  • “关闭网络1中节点alice上的通道abc123:0”
  • “在alice上创建10000个sats的闪电发票”
  • “从bob支付此Lightning发票：[发票字符串]”

Taproot资产：

  • “在alice tap上创建一个名为'TestToken'的新资产，包含1000个单位”
  • “将100单位资产abc123发送到bob的Taproot资产地址”
  • “在alice上为50单位资产xyz789创建资产发票”
  • “使用资产xyz789从bob支付此资产发票”

复杂任务：

  • 创建一个包含2个LND节点和1个Taproot资产节点的网络，启动它，挖掘100个区块，然后创建一个新资产
  • 建立一个完整的闪电网络：创建网络、资金节点、开放渠道、造币资产和创建资产地址
  • “显示所有网络及其当前状态，包括节点运行状况和余额”

可用工具

MCP服务器从Polar动态发现40多种工具，按类别组织：

  • 网络管理 （12个工具）：创建、启动/停止、重命名网络；添加/删除/重命名节点
  • 比特币操作 （5个工具）：挖掘区块、发送交易、钱包管理
  • 雷电作业 （13个工具）：渠道、付款、发票、节点信息
  • Taproot资产 （7个工具）：造币、发送、管理资产和地址
  • 资产渠道 （3个工具）：资金和关闭资产支持渠道
  • 资产支付 （2个工具）：创建和支付资产发票
  • 避雷终端 （3个工具）：LNC会话管理

有关所有可用工具及其参数和说明的完整参考，请参阅 TOOLS.md.

建筑

┌─────────────┐         ┌─────────────────┐         ┌──────────────┐
│  AI Client  │ stdio   │  MCP Server     │  HTTP   │  Polar App   │
│  (Claude)   │◄───────►│  (This Package) │◄───────►│  (Electron)  │
└─────────────┘         └─────────────────┘         └──────────────┘
                             Port 37373                   UI Updates
  • MCP服务器使用stdio（标准输入/输出）与AI客户端通信
  • 它连接到Polar的HTTP网桥 localhost:37373
  • Polar的Redux商店更新，触发实时UI更新

故障排除

“无法连接到Polar”

解决方案：在启动AI助手之前，请确保Polar应用程序正在运行。

您可以通过检查健康端点来验证Polar是否正在运行：

curl http://localhost:37373/health
# Should return: {"status":"ok","service":"polar-mcp-bridge"}

“端口37373已在使用中”

解决方案：另一个应用程序正在使用端口37373。关闭它或重新启动Polar。

工具未出现在Claude中

解决方案:

  1. 完全重新启动Claude Desktop（退出并重新启动）
  2. 检查配置文件语法是否为有效的JSON
  3. 检查Claude的MCP日志（帮助→ 在Claude Desktop中查看日志）

发展

要从源代码构建，请执行以下操作：

yarn install
yarn build

贡献

欢迎投稿！请看主 极地存储库 关于贡献指南。

许可证

麻省理工学院-参见 许可证 文件

链接

相关 MCP