zkApp交易查询服务

Mina MCP服务器为AI模型提供查询和检索Mina区块链上zkApp交易信息的能力,适用于区块链开发和数据分析场景。

  • by ronykris
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ronykris/mina-mcp-server

使用说明

我的 MCP 服务器

一个模型上下文协议(MCP)服务器,提供来自Mina区块链的zkApp交易信息。

概述

此MCP服务器为AI模型提供了查询和检索Mina区块链上zkApp交易信息的能力。它使用Blockberry API获取交易数据并对其进行格式化,以方便消费。

服务器实现 模型上下文协议(MCP),这允许像Claude这样的AI模型访问外部工具和数据源。当连接到兼容MCP的客户端(如Claude Desktop)时,该服务器使AI能够提供有关Mina区块链上zkApp交易的实时信息。

特性

  • 按交易哈希查询特定zkApp交易
  • 使用分页支持获取最近的zkApp事务
  • 按帐户ID筛选交易
  • 详细的交易格式包括:
    • 交易状态和区块高度
    • 费用支付人/证明人信息
    • 更新的帐户及其状态更改
    • 潜在可疑交易的安全警告
    • 平衡变化和时间戳信息

演示

先决条件

  • Blockberry API密钥(在 蔓越莓)
  • Claude Desktop或其他兼容MCP的客户端

用法

与Claude Desktop一起使用

要将Mina MCP服务器与Claude Desktop(Anthropic的Claude桌面应用程序)一起使用,请执行以下步骤:

  1. 下载并安装Claude Desktop:

    • macOS/Windows: 访问Claude Desktop官方下载页面,获取适用于您操作系统的应用程序。安装应用程序并确保您使用的是最新版本(您可以在应用程序菜单中检查更新)。
    • Linux: 虽然Anthropic尚未正式支持Linux,但您可以使用社区维护的版本,网址为 https://github.com/aaddrick/claude-desktop-debian.
  2. 配置Claude Desktop以使用Mina MCP服务器: 打开Claude Desktop配置文件(首次在Claude Desktop中编辑设置时创建):

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: 这将取决于安装方法,但很可能 ~/.config/Claude/claude_desktop_config.json

    在此JSON配置中,在以下位置添加Mina MCP服务器的条目 "mcpServers" 章节:

    {
      "mcpServers": {
        "mina-mcp": {
          "command": "bash",
          "args": [
             "-c", "BLOCKBERRY_API_KEY=your_api_key npx mina-mcp-server"
             ]         
        }
      }
    }
    

    在此配置中:

    • "mina-mcp" 是服务器的标识符
    • 这 command 设置为运行 bash 命令
    • args 告诉npx运行mina-mcp包的最新版本,同时将blockberryapi密钥设置为env变量

可用工具

获取zkapp交易

通过哈希值获取特定zkApp交易的详细信息。

参数:

  • txHash (string):要查找的交易哈希

例子:

{
  "name": "get-zkapp-transaction",
  "parameters": {
    "txHash": "5JtRyvAiXf7mXB5JsWuUVYsBYPDPwP55JCAPR2cDG8yRb1Pc3q8T"
  }
}

获取最近的zkapp交易记录

获取具有分页支持的最近zkApp事务列表。

参数:

  • page (数字,默认值:0):页码(从0开始)
  • size (数字,默认值:20):每页交易数(最大值:50)
  • accountId (字符串,可选):按帐户ID筛选
  • orderBy (枚举:“ASC”或“DESC”,默认值:“DESC“):排序方向
  • sortBy (字符串,默认值:“AGE”):排序参数

例子:

{
  "name": "get-recent-zkapp-transactions",
  "parameters": {
    "page": 0,
    "size": 10,
    "orderBy": "DESC",
    "sortBy": "AGE"
  }
}

鸣谢