ldk服务器mcp
注： 此回购已转移到 ldk-server 工作空间，因此被存档。
建筑
cargo build --release配置
服务器按此优先级顺序读取配置（最高获胜）：
- 环境变量:
LDK_BASE_URL,LDK_API_KEY,LDK_TLS_CERT_PATH - CLI参数: `--config
` 指向TOML配置文件
- 默认路径:
~/.ldk-server/config.toml,~/.ldk-server/tls.crt,~/.ldk-server/{network}/api_key
TOML配置格式与 ldk-server-cli:
[node]
grpc_service_address = "127.0.0.1:3536"
network = "signet"
[tls]
cert_path = "/path/to/tls.crt"用法
独立
export LDK_BASE_URL="localhost:3000"
export LDK_API_KEY="your_hex_encoded_api_key"
export LDK_TLS_CERT_PATH="/path/to/tls.crt"
./target/release/ldk-server-mcp或者使用配置文件：
./target/release/ldk-server-mcp --config /path/to/config.toml使用克劳德桌面
将以下内容添加到您的Claude Desktop MCP配置中(claude_desktop_config.json):
{
"mcpServers": {
"ldk-server": {
"command": "/path/to/ldk-server-mcp",
"env": {
"LDK_BASE_URL": "localhost:3000",
"LDK_API_KEY": "your_hex_encoded_api_key",
"LDK_TLS_CERT_PATH": "/path/to/tls.crt"
}
}
}
}使用克劳德代码
添加到您的Claude Code MCP设置中(.claude/settings.json):
{
"mcpServers": {
"ldk-server": {
"command": "/path/to/ldk-server-mcp",
"env": {
"LDK_BASE_URL": "localhost:3000",
"LDK_API_KEY": "your_hex_encoded_api_key",
"LDK_TLS_CERT_PATH": "/path/to/tls.crt"
}
}
}
}可用工具
服务器将37个一元LDK服务器RPC作为MCP工具公开。
流式RPC，例如 subscribe_events 以及非RPC HTTP端点，例如 metrics 不作为工具暴露。
节点
| 工具 | 说明 |
|---|---|
get_node_info | 检索节点信息，包括node_id、同步状态和最佳块 |
get_balances | 检索所有已知余额的概览（链上和闪电） |
在链上
| 工具 | 说明 |
|---|---|
onchain_receive | 生成新的链上比特币融资地址 |
onchain_send | 将链上比特币支付发送到一个地址 |
支付
| 工具 | 说明 |
|---|---|
bolt11_receive | 创建BOLT11闪电发票以接收付款 |
bolt11_receive_for_hash | 为特定付款哈希创建BOLT11闪电发票 |
bolt11_claim_for_hash | 手动为特定付款哈希申请BOLT11付款 |
bolt11_fail_for_hash | 手动失败特定支付哈希的BOLT11支付 |
bolt11_receive_via_jit_channel | 创建BOLT11闪电发票，通过LSPS2 JIT渠道接收 |
bolt11_receive_variable_amount_via_jit_channel | 创建可变金额BOLT11闪电发票，通过LSPS2 JIT渠道接收 |
bolt11_send | 支付BOLT11闪电发票 |
bolt12_receive | 创建BOLT12报价以接收闪电付款 |
bolt12_send | 支付BOLT12闪电优惠 |
spontaneous_send | 向Lightning节点发送自发（密钥发送）付款 |
unified_send | 根据BIP 21 URI或BIP 353人类可读名称发送付款 |
频道
| 工具 | 说明 |
|---|---|
open_channel | 使用远程节点打开新的Lightning通道 |
close_channel | 合作关闭闪电通道 |
force_close_channel | 单方面强制关闭闪电通道 |
list_channels | 列出所有已知的闪电通道 |
update_channel_config | 更新频道的转发费和CLTV增量 |
splice_in | 通过加入链上资金来增加渠道的余额 |
splice_out | 通过拼接到链上来降低通道的平衡 |
付款历史记录
| 工具 | 说明 |
|---|---|
list_payments | 列出所有付款（支持通过page_token分页） |
get_payment_details | 通过ID获取特定付款的详细信息 |
list_forwarded_payments | 列出所有转发的付款（支持通过page_token分页） |
同行
| 工具 | 说明 |
|---|---|
connect_peer | 无需打开通道即可连接到Lightning对等端 |
disconnect_peer | 断开与Lightning对等端的连接 |
list_peers | 列出所有已知的Lightning对等体 |
公用事业
| 工具 | 说明 |
|---|---|
decode_invoice | 解码BOLT11发票并返回其解析字段 |
decode_offer | 解码BOLT12报价并返回其解析字段 |
sign_message | 使用节点的密钥对消息进行签名 |
verify_signature | 根据消息和公钥验证签名 |
export_pathfinding_scores | 导出Lightning路由器使用的寻路分数 |
MCP协议
- 协议版本:
2024-11-05 - 运输：stdio（每行一条JSON-RPC 2.0消息）
- 方法:
initialize,tools/list,tools/call
测试
cargo test许可证
根据以下任一方式获得许可
- Apache许可证，版本2.0(特许通行证 或http://www.apache.org/licenses/LICENSE-2.0)
- MIT许可证(许可证-麻省理工学院 或http://opensource.org/licenses/MIT)
由您选择。