Penumbra MCP Server

Penumbra 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 を使用します：

yarn add @timeheater/penumbra-mcp

セットアップ

ソースからのローカル開発

1. 依存関係をインストールします：

npm install

2. サーバーをビルドします：

npm run build

3. 開発モードで実行します：

npm run watch

Claude Desktop との連携

Claude desktop と連携するには、次の設定を Claude desktop の設定ファイル（~/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 を操作できます：

1. バリデーターセットを照会する：

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

2. チェーンの状態を確認する：

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

3. トランザクションの詳細を取得する：

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

4. DEX の状態を表示する：

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

5. ガバナンス提案の一覧を取得する：

Tell Claude: "List active Penumbra governance proposals"

開発

• npm run watch：開発用のウォッチモード
• npm run inspector：テスト用に MCP inspector を実行します
• 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 days）
• PENUMBRA_GOVERNANCE_MIN_DEPOSIT：提案に必要な最小デポジット額（デフォルト：100000）

アーキテクチャ

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

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

すべてのやり取りにおいて、Penumbra のプライバシー保護設計が尊重されます：

• シールドされたトランザクション
• プライベートなステーキング操作
• 封印入札方式のバッチオークション
• 匿名のガバナンス投票

貢献

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

ライセンス

ISC