ペナンブラ MCP サーバー

Penumbraブロックチェーンと連携するためのツールを提供するMCPサーバー。このサーバーは、トランザクションクエリ、バリデータセット情報、DEX状態、ガバナンス提案といったPenumbraのコア機能とのプライバシー保護された連携を可能にします。

特徴

現在のツール

get_validator_set : 現在のバリデータセット情報を取得する
get_chain_status : ブロックの高さやチェーンIDを含む現在のチェーンステータスを取得します。
get_transaction : 特定のトランザクションの詳細を取得する
get_dex_state : 最新のバッチオークション結果を含む現在のDEX状態を取得します。
get_governance_proposals : アクティブなガバナンス提案を取得する

計画されている機能

取引の提出
プライベートステーキング業務
DEX取引（密封入札バッチオークション）
民間ガバナンス投票
流動性ポジション管理

インストール

npm 経由でパッケージをインストールできます:

npm install @timeheater/penumbra-mcp

または糸を使う:

yarn add @timeheater/penumbra-mcp

設定

源泉からの地域開発

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

開発モードで実行:

npm run watch

クロードデスクトップ統合

Claude デスクトップと統合するには、Claude デスクトップ設定ファイル ( ~/Library/Application Support/Claude/claude_desktop_config.json ) に次の構成を追加します。

{
  "mcpServers": {
    "penumbra-mcp": {
      "command": "node",
      "args": ["/Users/barton/infinity-topos/penumbra-mcp/build/index.js"],
      "env": {
        "PENUMBRA_NODE_URL": "https://rpc.penumbra.zone",
        "PENUMBRA_NETWORK": "mainnet",
        "PENUMBRA_CHAIN_ID": "penumbra-1",
        "PENUMBRA_REQUEST_TIMEOUT": "30000",
        "PENUMBRA_REQUEST_RETRIES": "5",
        "PENUMBRA_BLOCK_TIME": "6000",
        "PENUMBRA_EPOCH_DURATION": "100",
        "PENUMBRA_DEX_BATCH_INTERVAL": "60000",
        "PENUMBRA_DEX_MIN_LIQUIDITY": "1000",
        "PENUMBRA_DEX_MAX_PRICE_IMPACT": "0.05",
        "PENUMBRA_GOVERNANCE_VOTING_PERIOD": "1209600000",
        "PENUMBRA_GOVERNANCE_MIN_DEPOSIT": "100000"
      }
    }
  }
}

/path/to/penumbra-mcpを、サーバーをインストールした実際のパスに置き換えます。

MCPサーバーの使用

設定が完了すると、次のツールを使用して Claude を通じて Penumbra と対話できるようになります。

クエリ検証セット:

Tell Claude: "Show me the current Penumbra validator set"

チェーンのステータスを確認します:

Tell Claude: "What's the current status of the Penumbra chain?"

取引の詳細を取得します:

Tell Claude: "Look up Penumbra transaction [HASH]"

DEX の状態を表示します。

Tell Claude: "Show me the current Penumbra DEX state"

ガバナンス提案を一覧表示します。

Tell Claude: "List active Penumbra governance proposals"

発達

npm run watch : 開発用のウォッチモード
npm run inspector : テスト用にMCPインスペクターを実行する
npm test : テストスイートを実行する

環境変数

ノード構成

PENUMBRA_NODE_URL : Penumbra ノードの URL (デフォルト: https://rpc.penumbra.zone )
PENUMBRA_REQUEST_TIMEOUT : HTTPリクエストのタイムアウト（ミリ秒）（デフォルト: 30000）
PENUMBRA_REQUEST_RETRIES : リクエストの再試行回数（デフォルト: 5）

チェーン構成

PENUMBRA_NETWORK : 接続先のネットワーク（デフォルト: mainnet）
PENUMBRA_CHAIN_ID : チェーンID (デフォルト: penumbra-1)
PENUMBRA_BLOCK_TIME : ブロック時間（ミリ秒）（デフォルト: 6000）
PENUMBRA_EPOCH_DURATION : エポックあたりのブロック数（デフォルト: 100）

DEX構成

PENUMBRA_DEX_BATCH_INTERVAL : バッチオークション間隔（ミリ秒）（デフォルト: 60000）
PENUMBRA_DEX_MIN_LIQUIDITY : 最小流動性額（デフォルト: 1000）
PENUMBRA_DEX_MAX_PRICE_IMPACT : 最大価格影響度（小数点）（デフォルト: 0.05）

ガバナンス構成

PENUMBRA_GOVERNANCE_VOTING_PERIOD : 投票期間（ミリ秒）（デフォルト: 1209600000 - 14日）
PENUMBRA_GOVERNANCE_MIN_DEPOSIT : 提案の最低預入金額（デフォルト: 100000）

建築

このサーバーはTypeScriptを使用して構築されており、標準化されたツールインターフェースのためのModel Context Protocol（MCP）を実装しています。現在、コア機能のモック実装を提供しており、PenumbraのクライアントライブラリおよびノードAPIエンドポイントと直接統合する予定です。

プライバシーに関する考慮事項

すべてのインタラクションは、Penumbra のプライバシー保護設計を尊重します。

保護された取引
プライベートステーキング業務
密封入札バッチオークション
匿名ガバナンス投票

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

ISC

Penumbra MCP Server