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 桌面集成

要与 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: 运行 MCP 检查器进行测试
• 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 天）
• PENUMBRA_GOVERNANCE_MIN_DEPOSIT: 最小提案押金金额（默认值：100000）

架构

服务器使用 TypeScript 构建，并实现了模型上下文协议（MCP）以实现标准化工具接口。目前提供了核心功能的模拟实现，计划直接集成 Penumbra 的客户端库和节点 API 端点。

隐私考虑

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

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

贡献

欢迎贡献！请随时提交拉取请求。

许可证

ISC