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，但您可以使用社区维护的版本，网址为 .

1. 配置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"
  }
}

鸣谢

• 内置于 模型上下文协议SDK
• 交易数据由提供 Blockberry API
• 影响 比特币MCP服务器