🚀 佩恩布拉斯 MCP 服务器

佩恩布拉斯 MCP 服务器是一个提供与佩恩布拉斯区块链交互工具的平台。它支持隐私保护功能，可用于事务查询、获取验证器集信息、查看 DEX 状态以及治理提案等操作。

🚀 快速开始

配置完成后，您可以通过Claude与Penumbra交互：

1. 查询验证器集合：

告诉Claude：显示当前佩恩布拉斯验证者集合

2. 检查链状态：

告诉Claude：佩恩布拉斯链的当前状态是什么？

3. 获取事务详细信息：

告诉Claude：查看佩恩布拉斯事务 [HASH]

4. 查看DEX状态：

告诉Claude：显示当前佩恩布拉斯DEX状态

5. 列出治理提案：

告诉Claude：列出活动佩恩布拉斯治理提案

✨ 主要特性

当前工具

• 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桌面设置文件（~/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替换为您实际安装服务器的路径。

📚 详细文档

开发

• npm run watch：开发模式监视
• npm run inspector：运行检查程序
• npm run build：构建服务器
• npm run test：运行测试

架构

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

隐私考虑

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

• 带有屏蔽的事务
• 私密质押操作
• 密封出价批量拍卖
• 匿名治理投票

📄 许可证

ISC