Penumbra MCP Server

Penumbra MCP 服务器

一个 MCP 服务器，提供与 Penumbra 区块链交互的工具。该服务器支持与 Penumbra 的核心功能（包括交易查询、验证器集信息、DEX 状态和治理提案）进行隐私保护交互。

特征

当前工具

• get_validator_set ：获取当前验证器集合信息
• get_chain_status ：获取当前链状态，包括区块高度和链 ID
• get_transaction ：获取特定交易的详细信息
• get_dex_state ：获取当前 DEX 状态，包括最新批次拍卖结果
• get_governance_proposals ：获取有效的治理提案

计划功能

• 交易提交
• 私人质押操作
• DEX交易（密封批量拍卖）
• 私人治理投票
• 流动性头寸管理

安装

您可以通过 npm 安装该包：

或者使用纱线：

设置

从源头进行本地开发

1. 安装依赖项：

2. 构建服务器：

3. 以开发模式运行：

Claude 桌面集成

要与 Claude 桌面集成，请将以下配置添加到您的 Claude 桌面设置文件（ ~/Library/Application Support/Claude/claude_desktop_config.json ）：

将/path/to/penumbra-mcp替换为您安装服务器的实际路径。

使用 MCP 服务器

配置完成后，您可以使用以下工具通过 Claude 与 Penumbra 进行交互：

1. 查询验证器集：

2. 检查链状态：

3. 获取交易详情：

4. 查看DEX状态：

5. 列出治理提案：

发展

• 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 请求。

执照

国际学习中心