Pblittle Lightning MCP Server

🚀 ライトニングネットワーク MCP サーバー

ライトニングネットワーク MCP サーバーは、大型言語モデル (LLM) エージェント（例えば Goose で動作するエージェント）が自然言語でライトニングノードデータを照会できるようにします。このサーバーは Model Context Protocol (MCP) 仕様バージョン 2025-03-26 を実装しており、MCP チェッカー 1.7.0 と完全に互換性があります。

このサーバーは、gRPC または Lightning Node Connect (LNC) を介してノードに接続し、人間が読める要約と機械が読める JSON 出力を返します。モジュール化、テスト容易性、拡張性を念頭に設計されており、Core Lightning や Eclair などのさまざまなタイプのノードをサポートする予定です。

アーキテクチャの詳細については、ARCHITECTURE.md を参照してください。

✨ 主な機能

このシステムは自然言語のプロンプトを解釈し、ユーザーの意図を特定し、ドメインロジックを評価して、ライトニングノードを照会します。応答は純粋なテキストと構造化された JSON で返されます。現在は基本的なチャネル照会がサポートされており、さらなる機能が開発中です。

🚀 クイックスタート

1. .env.example ファイルをコピーして設定します。
2. npm run build を実行してプロジェクトをビルドします。
3. MCP チェッカーを使用してサーバーの互換性をテストします。

Tor を介した LND ノードの接続

Tor を介してリモートの LND ノードに接続するには、以下の手順に従ってください：

1. Tor サービスをインストールして起動します。
2. socks-proxy と http-proxy 環境変数を設定します。
3. .env ファイルにプロキシパラメータを設定します。

認証情報抽出ツールの使用

lndconnect URL を使用する場合、証明書とキーを抽出するスクリプトを実行できます：

node scripts/extract-credentials.js "lndconnect://your-node.onion:10009?cert=BASE64CERT&macaroon=BASE64MACAROON"

このスクリプトは証明書を PEM 形式に変換し、test/fixtures ディレクトリに保存します。

💻 使用例

基本的な使用法

npm install -g @modelcontextprotocol/inspector
npm run build
LOG_LEVEL=warn npx @modelcontextprotocol/inspector node scripts/inspect.js

📚 ドキュメント

互換性

貢献方法

貢献ガイドについては、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE を参照してください。