MCP Server for Bitcoin Lightning

Bitcoin Lightning MCP 服务

此仓库使用 https://github.com/ehallmark/btc-lightning-client 与本地 Lightning Network Daemon（lnd）通信，并将其封装为 Model Context Protocol（MCP）服务。此 MCP 服务可与 Agentic 系统配合使用，以与 Lightning Network 交互。

前置条件

• Python >= 3.10
• 使用 uv 进行包管理
• 你的机器上必须运行 Lightning Network Daemon（lnd）。如需了解有关 lnd 的更多信息，请访问 https://github.com/lightningnetwork/lnd。

运行 MCP 服务

export LIGHTNING_RPC_PORT=<lnd_port>
export LIGHTNING_CERT_PATH="/path/to/lnd/tls.cert"
export LIGHTNING_MACAROON_PATH=/path/to/bitcoin/simnet/admin.macaroon
export UVICORN_PORT=<some port>
export UVICORN_HOST=<some host>

uv run main.py

连接到 MCP 服务

此服务使用 SSE 进行传输。

使用 LangGraph 框架时，你可以通过以下适配器连接到它：

from contextlib import asynccontextmanager
from langchain_mcp_adapters.client import MultiServerMCPClient

@asynccontextmanager
async def make_graph():
    async with MultiServerMCPClient(
        {
            'lightning': {
                'url': 'http://localhost:8000/sse',
                'transport': 'sse',
            }
        }
    ) as lightning_mcp:
        workflow = create_workflow(user, lightning_mcp)
        graph = workflow.compile()
        yield graph