Penumbra MCP Server

基本能力

产品定位

Penumbra MCP Server 是一个专注于隐私保护的区块链交互工具服务器，主要用于与 Penumbra 区块链进行安全、隐私的交互。

核心功能

• 当前工具
• get_validator_set: 获取当前验证者集信息
• get_chain_status: 获取当前链状态，包括区块高度和链 ID
• get_transaction: 获取特定交易的详细信息
• get_dex_state: 获取当前 DEX 状态，包括最新批量拍卖结果

• get_governance_proposals: 获取活跃的治理提案

• 计划功能

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

适用场景

• 区块链开发者需要与 Penumbra 区块链进行隐私保护的交互
• 用户需要查询 Penumbra 区块链的状态、交易和治理提案
• DEX 交易者需要获取市场状态和进行隐私交易

工具列表

• get_validator_set: 获取验证者集信息
• get_chain_status: 获取链状态
• get_transaction: 获取交易详情
• get_dex_state: 获取 DEX 状态
• get_governance_proposals: 获取治理提案

常见问题解答

• 如何配置节点 URL？ 通过环境变量 PENUMBRA_NODE_URL 设置。
• 请求超时如何调整？ 通过环境变量 PENUMBRA_REQUEST_TIMEOUT 设置。
• 如何查询交易？ 使用 get_transaction 工具并提供交易哈希。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm/yarn。

安装教程

1. 通过 npm 安装：

npm install @timeheater/penumbra-mcp

或通过 yarn 安装：

yarn add @timeheater/penumbra-mcp

本地开发

1. 安装依赖：

npm install

1. 构建服务器：

npm run build

1. 开发模式运行：

npm run watch

Claude 桌面集成

1. 编辑 Claude 桌面配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json) 并添加 MCP 服务器配置。

调试方式

1. 运行测试套件：

npm test

1. 使用 MCP 检查器进行测试：

npm run inspector

许可证

该项目遵循 ISC 开源许可条款。