AI导哈

区块链交互服务器

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

  • by bmorphism
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 bmorphism/penumbra-mcp

使用说明

半影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 add @timeheater/penumbra-mcp

设置

从源头上发展地方

  1. 安装依赖项：
npm install
  1. 构建服务器：
npm run build
  1. 在开发模式下运行：
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. 查询验证器集：
Tell Claude: "Show me the current Penumbra validator set"
  1. 检查链条状态：
Tell Claude: "What's the current status of the Penumbra chain?"
  1. 获取交易详细信息：
Tell Claude: "Look up Penumbra transaction [HASH]"
  1. 查看DEX状态：
Tell Claude: "Show me the current Penumbra DEX state"
  1. 列出治理建议：
Tell Claude: "List active Penumbra governance proposals"

发展

  • npm run watch：观看模式用于开发
  • npm run inspector：运行MCP检查器进行测试
  • npm test：运行测试套件

环境变量

节点配置

  • PENUMBRA_NODE_URL：半影节点的URL（默认值：https://rpc.penumbra.zone)
  • PENUMBRA_REQUEST_TIMEOUT：HTTP请求超时（毫秒）（默认值：30000）
  • PENUMBRA_REQUEST_RETRIES：请求重试次数（默认值：5）

链构型

  • PENUMBRA_NETWORK：要连接的网络（默认：主网）
  • PENUMBRA_CHAIN_ID：链ID（默认值：半影-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）。它目前为核心功能提供了mock实现，并计划直接与Penumbra的客户端库和节点API端点集成。

保密考虑

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

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

贡献

欢迎投稿！请随时提交拉取请求。

许可证

国际协调委员会

相关 MCP