Penumbra MCP

🚀 佩恩布拉斯 MCP サーバ

佩恩布拉斯ブロックチェーンとのインタラクションツールを提供するMCPサーバです。このサーバは、トランザクションクエリ、バリデーターセット情報、DEX状態、およびガバナンス提案などのプライバシー保護機能をサポートしています。

✨ 主な機能

現在のツール

• 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デスクトップへの統合

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とインタラクトできます：

1. バリデーターセットをクエリする：

Claudeに「現在のPenumbraバリデーターセットを表示」と伝えます。

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

Claudeに「Penumbraチェーンの現在の状態は何ですか？」と伝えます。

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

Claudeに「Penumbraトランザクション [HASH] を表示」と伝えます。

4. DEXの状態を確認する：

Claudeに「現在のPenumbra DEXの状態を表示」と伝えます。

5. ガバナンス提案を一覧表示する：

Claudeに「アクティブなPenumbraガバナンス提案を一覧表示」と伝えます。

🔧 技術詳細

開発コマンド

• npm run watch：開発モードで監視します。
• npm run inspector：インスペクターを実行します。
• npm run build：サーバをビルドします。
• npm run test：テストを実行します。

アーキテクチャ

このサーバはTypeScriptで構築され、標準ツールインターフェイスを実現するためにモデルコンテキストプロトコル（MCP）を実装しています。現在は、核心機能に対して模擬実装を提供しており、PenumbraのクライアントライブラリとノードAPIエンドポイントとの統合が予定されています。

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

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

• 遮蔽されたトランザクション
• プライベートステーキング操作
• 密封入札バッチオークション
• 匿名ガバナンス投票

🤝 コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

ISC