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：

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: "Show me the current Penumbra validator set" (告诉我当前的 Penumbra 验证者集合)

2. 检查链状态：

告诉 Claude: "What's the current status of the Penumbra chain?" (Penumbra 链的当前状态是什么？)

3. 获取交易详情：

告诉 Claude: "Look up Penumbra transaction [HASH]" (查找 Penumbra 交易 [HASH])

4. 查看 DEX 状态：

告诉 Claude: "Show me the current Penumbra DEX state" (告诉我当前的 Penumbra DEX 状态)

5. 列出治理提案：

告诉 Claude: "List active Penumbra governance proposals" (列出活跃的 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: 每个 epoch 的区块数 (默认: 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 Request。

许可证

ISC