Mina MCP Server
2025.03.05
2
TypeScript区块链服务交易查询金融服务
Mina MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于从 Mina 区块链中查询和检索 zkApp 交易信息。它通过 Blockberry API 获取交易数据，并将其格式化以便于 AI 模型或其他客户端使用。该服务器与 MCP 兼容的客户端（如 Claude Desktop）配合使用，能够提供关于 Mina 区块链上 zkApp 交易的实时信息。
View on GitHub
Overview
基本能力
产品定位
Mina MCP Server 是一个专门用于 Mina 区块链上 zkApp 交易信息查询的服务，旨在为 AI 模型和开发者提供实时、详细的交易数据。
核心功能
- 通过交易哈希查询特定的 zkApp 交易
- 支持分页获取最近的 zkApp 交易
- 按账户 ID 过滤交易
- 详细的交易格式化，包括：
- 交易状态和区块高度
- 费用支付者/证明者信息
- 更新的账户及其状态变化
- 对潜在可疑交易的安全警告
- 余额变化和时间戳信息
适用场景
- AI 模型需要实时查询 Mina 区块链上的 zkApp 交易信息
- 开发者需要监控和分析特定账户的交易活动
- 需要获取详细交易数据以进行安全审计或分析
工具列表
- get-zkapp-transaction：通过交易哈希获取特定 zkApp 交易的详细信息。
- 参数：
txHash（字符串） - get-recent-zkapp-transactions：获取最近的 zkApp 交易列表，支持分页和过滤。
- 参数：
page（数字，默认 0）、size（数字，默认 20）、accountId（字符串，可选）、orderBy（枚举："ASC" 或 "DESC"，默认 "DESC"）、sortBy（字符串，默认 "AGE"）
常见问题解答
- 如何获取 Blockberry API 密钥？：访问 Blockberry 注册并获取 API 密钥。
- 如何配置 Claude Desktop 使用 Mina MCP Server？：编辑 Claude Desktop 的配置文件，添加 Mina MCP Server 的配置信息。
使用教程
使用依赖
- 获取 Blockberry API 密钥：访问 Blockberry 注册并获取 API 密钥。
- 安装 Claude Desktop 或其他 MCP 兼容客户端。
安装教程
- 下载并安装 Claude Desktop：
- macOS/Windows：访问 Claude Desktop 官方下载页面获取应用并安装。
- Linux：使用社区维护的版本 https://github.com/aaddrick/claude-desktop-debian。
- 配置 Claude Desktop 使用 Mina MCP Server：
- 打开 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
- macOS：
- 在
"mcpServers"部分添加 Mina MCP Server 的配置：json { "mcpServers": { "mina-mcp": { "command": "bash", "args": [ "-c", "BLOCKBERRY_API_KEY=your_api_key npx mina-mcp-server" ] } } }
调试方式
- 确保 Blockberry API 密钥正确设置。
- 检查 Claude Desktop 配置文件中的 Mina MCP Server 配置是否正确。
- 运行
npx mina-mcp-server命令，确保服务能够正常启动。