使用说明

项目简介

lightning-tools-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 应用提供便捷的闪电网络 (Lightning Network) 工具。通过此 MCP 服务器，LLM 可以安全地与闪电网络进行交互，例如请求闪电发票、进行法币与聪 (Satoshi) 的价值转换等。

主要功能点

闪电地址发票请求 (request_invoice): 允许 LLM 通过指定闪电地址和金额，向收款人请求闪电网络发票。
法币兑换聪 (fiat_to_sats): 允许 LLM 查询指定法币金额对应的聪 (Satoshi) 数量，方便进行价值换算。

安装步骤

安装 Node.js 和 Yarn: 确保你的系统已安装 Node.js (版本 20+) 和 Yarn 包管理器。

克隆仓库: 将仓库 'lightning-tools-mcp-server' 克隆到本地。

git clone https://github.com/getAlby/lightning-tools-mcp-server.git
cd lightning-tools-mcp-server

安装依赖: 在仓库目录下运行以下命令安装项目依赖。
```
yarn install
```
构建项目: 运行以下命令构建项目。
```
yarn build
```

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以下是针对不同 MCP 客户端的配置示例。

对于 Claude Desktop 客户端：

在 'claude_desktop_config.json' 文件中，将以下 JSON 配置添加到 'mcpServers' 字段中。

{
  "mcpServers": {
    "lightning-tools": {
      "command": "npx",
      "args": ["-y", "@getalby/lightning-tools-mcp-server"],
      "env": {}
    }
  }
}

配置参数说明:

'"lightning-tools"': 服务器名称，可以自定义，用于在客户端中标识和引用该服务器。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'"args": ["-y", "@getalby/lightning-tools-mcp-server"]': 传递给 'npx' 的参数，'-y' 表示自动确认安装包，'@getalby/lightning-tools-mcp-server' 是要运行的 npm 包名称。
'"env": {}': 环境变量配置，默认为空。

对于 Cline 客户端：

在 Cline 客户端的提示中，粘贴以下 JSON 配置并发送，即可添加到 MCP 服务器列表。

{
  "lightning-tools": {
    "command": "npx",
    "args": ["-y", "@getalby/lightning-tools-mcp-server"],
    "env": {},
    "disabled": false,
    "autoApprove": []
  }
}

配置参数说明 (Cline 与 Claude Desktop 相同):

'"lightning-tools"': 服务器名称。
'"command": "npx"': 启动命令。
'"args": ["-y", "@getalby/lightning-tools-mcp-server"]': 命令参数。
'"env": {}': 环境变量。
'"disabled": false': 是否禁用服务器，'false' 表示启用。
'"autoApprove": []': 自动批准的工具列表，默认为空，表示所有工具都需要手动批准。

基本使用方法

启动服务器: 配置完成后，当 MCP 客户端（如 Claude Desktop 或 Cline）启动并需要使用闪电网络工具时，lightning-tools-mcp-server 会自动启动。
客户端调用工具: 在 LLM 客户端中，可以通过自然语言指令或特定语法调用 'lightning-tools' 服务器提供的工具，例如：
- 请求闪电发票: "请向 'lightning_address' 为 '[email protected]' 的地址请求 1000 聪的发票，备注为 '测试发票'"
- 法币兑换聪: "100 美元等于多少聪？"

具体的工具调用方式和参数需要参考 MCP 客户端的文档和工具的定义。

注意: 本服务器依赖于 '@getalby/lightning-tools' 库，并使用标准输入/输出 (stdio) 作为 MCP 传输协议。

关键词