Cln MCP

🚀 Core Lightning MCP Server

このRustベースのgRPCサーバーは、Core Lightningノードに対する標準化されたインターフェースを提供します。このサーバーはMCP（Model Context Protocol）仕様を実装し、LLMを使用してCore Lightningノードを制御できるようにします。

🚀 クイックスタート

このセクションでは、Core Lightning MCP Serverのインストールと設定方法を説明します。

📦 インストール

オプション1: リリース版からのインストール（推奨）

1. 最新リリースから、お使いのプラットフォームに適したバイナリをダウンロードします。
2. アーカイブを解凍します。

   # Linux/macOSの場合
   tar -xzf cln-mcp-<platform>.tar.gz
   
   # Windowsの場合
   # 好みのzip解凍ツールを使用してください
   

3. バイナリを実行可能にします（Linux/macOSのみ）。

   chmod +x cln-mcp
   

オプション2: ソースコードからのインストール

前提条件

• Rust 1.80以上
• Protocol Buffers Compiler (protoc)
• Core Lightning（gRPCを有効にする）
• MCPクライアント（Claude、Gooseなど）

Protocol Buffers Compiler (protoc)のインストール

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y protobuf-compiler

macOS:

brew install protobuf

Windows:

choco install protoc

インストールの確認:

protoc --version  # バージョン3.0.0以上が表示されるはずです

1. リポジトリをクローンします。

git clone https://github.com/adi2011/cln-mcp.git
cd cln-mcp

2. プロジェクトをビルドします。

cargo build --release

🔧 設定

サーバーはコマンドライン引数を使用して設定できます。

cln-mcp [OPTIONS]

Options:
  --certs-dir <path>    証明書ディレクトリへのパス
  --node-address <url>  ノードアドレス (デフォルト: https://localhost:9736)
  --help                ヘルプメッセージを表示

TLS証明書の設定

CLNを実行する際に--grpc-port（デフォルト: 9736）オプションを追加すると、適切なmTLS証明書が自動的に生成されます。

Lightningディレクトリから以下のPEMファイルを別のディレクトリにコピーします。

• ca.pem: CA証明書
• client.pem: クライアント証明書
• client-key.pem: クライアント秘密鍵

Claudeの設定

• Claudeをインストールします。
• 設定 -> 開発者に移動します。
• 設定を編集します。

   {
       "mcpServers" : {
           "cln-mcp" : {
               "command": "Path/to/cln-mcp" (例: "/Users/MyPC/cln-mcp/target/release/cln-mcp" またはリリースから解凍した実行可能ファイル),
               "args": [
                   "--certs-dir",
                   "Path/to/certificates" (例: "/Users/MyPC/cln-mcp/certs")
               ]
           }
       }
   }

• Claudeを再起動します。

🚀 将来的な目標

[ ] RPC呼び出しのパラメータを導出できるようにする
[ ] 最大限のユーティリティを得るために、最も適切で有用なRPCを選択する
[ ] LNDへのサポートを拡張する
[ ] 複数のサーバーをホストして、より効率的にする

このプロジェクトは進行中です。コードレビュー、プルリクエスト、使用に基づく問題報告を歓迎します。