返回市场
米娜-MCP服务器

米娜-MCP服务器

作者:ronykris3 星标更新:2025-03-05

项目介绍

Mina MCP 服务器

一个提供来自 Mina 区块链的 zkApp 交易信息的 Model Context Protocol (MCP) 服务器。

概述

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

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

功能

  • 通过交易哈希查询特定的 zkApp 交易
  • 支持分页获取最近的 zkApp 交易
  • 根据账户 ID 过滤交易
  • 详细的交易格式包括:
    • 交易状态和区块高度
    • 费用支付者/证明者信息
    • 更新的账户及其状态变化
    • 对潜在可疑交易的安全警告
    • 平衡变化和时间戳信息

示例

预备条件

  • 一个 Blockberry API 密钥(在 Blockberry 注册)
  • Claude Desktop 或其他兼容 MCP 的客户端

使用方法

使用 Claude Desktop

要使用 Mina MCP 服务器与 Claude Desktop(Anthropic 的桌面应用),请按照以下步骤操作:

  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
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: 这取决于安装方式,但很可能位于 ~/.config/Claude/claude_desktop_config.json

    在这个 JSON 配置的 "mcpServers" 部分添加 Mina MCP 服务器条目:

    {
      "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 包,同时将 blockberry api 密钥设置为环境变量

可用工具

get-zkapp-transaction

根据其哈希值获取特定 zkApp 交易的详细信息。

参数:

  • txHash (字符串): 要查找的交易哈希

示例:

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

get-recent-zkapp-transactions

获取带有分页支持的最近 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"
  }
}

致谢