Penumbra MCP

🚀 佩恩布拉斯 MCP 服務器

佩恩布拉斯 MCP 服務器是一個提供與佩恩布拉斯區塊鏈交互工具的平臺。它支持隱私保護功能，可用於事務查詢、獲取驗證器集信息、查看 DEX 狀態以及治理提案等操作。

🚀 快速開始

配置完成後，您可以通過Claude與Penumbra交互：

1. 查詢驗證器集合：

告訴Claude：顯示當前佩恩布拉斯驗證者集合

2. 檢查鏈狀態：

告訴Claude：佩恩布拉斯鏈的當前狀態是什麼？

3. 獲取事務詳細信息：

告訴Claude：查看佩恩布拉斯事務 [HASH]

4. 查看DEX狀態：

告訴Claude：顯示當前佩恩布拉斯DEX狀態

5. 列出治理提案：

告訴Claude：列出活動佩恩布拉斯治理提案

✨ 主要特性

當前工具

• 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桌面設置文件（~/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替換為您實際安裝服務器的路徑。

📚 詳細文檔

開發

• npm run watch：開發模式監視
• npm run inspector：運行檢查程序
• npm run build：構建服務器
• npm run test：運行測試

架構

服務器使用TypeScript構建，並實現模型上下文協議（MCP）以實現標準工具接口。目前，它為核心功能提供了模擬實現，並計劃與Penumbra的客戶端庫和節點API端點集成。

隱私考慮

所有交互均尊重Penumbra的隱私保護設計：

• 帶有屏蔽的事務
• 私密質押操作
• 密封出價批量拍賣
• 匿名治理投票

📄 許可證

ISC