Penumbra MCP 服务器

一个 MCP 服务器，提供与 Penumbra 区块链交互的工具。该服务器支持与 Penumbra 的核心功能（包括交易查询、验证器集信息、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 add @timeheater/penumbra-mcp

设置

从源头进行本地开发

安装依赖项：

npm install

构建服务器：

npm run build

以开发模式运行：

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 进行交互：

查询验证器集：

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 ：要连接的网络（默认值：主网）
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 构建，并实现了用于标准化工具接口的模型上下文协议 (MCP)。目前，它提供了核心功能的模拟实现，并计划直接与 Penumbra 的客户端库和节点 API 端点集成。

隐私考虑

所有互动都尊重 Penumbra 的隐私保护设计：

屏蔽交易
私人质押操作
密封投标批量拍卖
匿名治理投票

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

国际学习中心

Penumbra MCP Server