Penumbra MCP Server

Penumbra MCP 服务

一个用于与 Penumbra 区块链交互的 MCP 服务。该服务支持以保护隐私的方式使用 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：

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 的隐私保护设计：

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

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

ISC