Polar MCP 服务器

Polar Lightning 的 Model Context Protocol (MCP) 服务器。此服务器使像 Claude 这样的AI助手能够与 Polar 互动，以管理比特币闪电网络测试环境。

什么是 MCP？

Model Context Protocol 是一个开放标准，它允许AI助手安全地连接到外部数据源和工具。MCP 服务器暴露了LLMs可以发现并动态使用的功能。

功能

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

预备条件

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

安装

选项 1：使用 npx（推荐）

无需安装！只需在您的 MCP 客户端中添加以下配置。

选项 2：全局安装

yarn global add @lightningpolar/mcp

配置

Claude Desktop

在您的 Claude Desktop 配置文件中添加以下内容：

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

Windows: %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助手：打开 Claude Desktop（或您的 MCP 客户端）
3. 提问：AI现在可以与 Polar 互动

示例提示

网络管理：

• "列出我在 Polar 中的所有闪电网络"
• "创建一个名为 'test-network' 的新闪电网络，包含 2 个 LND 节点和 1 个 Taproot 资产节点"
• "启动网络 1"
• "停止所有正在运行的网络"

比特币操作：

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

闪电通道：

• "在网络 1 上从 alice 到 bob 打开一个带有 1,000,000 毛币的通道"
• "在网络 1 上的 alice 节点关闭通道 abc123:0"
• "在网络 1 上的 alice 创建一个价值 10,000 毛币的闪电发票"
• "从 bob 支付这个闪电发票：[发票字符串]"

Taproot 资产：

• "在网络 1 上的 alice-tap 铸造一个新的名为 'TestToken' 的资产，包含 1,000 单位"
• "将资产 abc123 的 100 单位发送到 bob 的 Taproot 资产地址"
• "在网络 1 上的 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 客户端  │ stdio   │  MCP 服务器     │  HTTP   │  Polar 应用  │
│  (Claude)   │◄───────►│  (此包)         │◄───────►│  (Electron)  │
└─────────────┘         └─────────────────┘         └──────────────┘
                             端口 37373                   UI 更新

• MCP 服务器使用 stdio（标准输入/输出）与 AI 客户端通信
• 它连接到 Polar 的 HTTP 桥接器 localhost:37373
• Polar 的 Redux 存储被更新，触发实时 UI 更新

故障排除

"无法连接到 Polar"

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

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

curl http://localhost:37373/health
# 应返回：{"status":"ok","service":"polar-mcp-bridge"}

"端口 37373 已被占用"

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

工具未出现在 Claude 中

解决方案：

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

开发

要从源代码构建：

yarn install
yarn build

贡献

欢迎贡献！请参阅主 Polar 仓库 获取贡献指南。

许可证

MIT - 查看 LICENSE 文件

链接

• Polar 网站
• Polar GitHub
• Model Context Protocol
• MCP 规范