项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器端应用。它的主要目标是将 Moralis Web3 数据服务的强大 REST API 封装成符合 MCP 标准的工具,从而使得支持 MCP 协议的大型语言模型 (LLM) 客户端能够方便、安全地调用 Moralis API,获取丰富的区块链数据和执行相关操作。

主要功能点

  • Moralis API 工具化: 将 Moralis REST API 的各个接口(如查询代币余额、获取NFT详情、获取交易历史等)转换为结构化的 LLM 工具,使得 LLM 可以理解并调用这些功能。
  • 区块链数据访问: 作为 LLM 访问底层区块链数据和 Moralis Web3 服务(如索引、数据同步、认证等)的通道。
  • 符合MCP标准: 使用官方 MCP SDK 开发,遵循 MCP 的协议规范,通过标准化的方式与 MCP 客户端进行通信(例如通过 Stdudio)。

安装步骤

要运行此 MCP 服务器,您需要安装 Node.js。此服务器通常作为一个 npm 包发布。根据仓库信息,最直接的运行方式是使用 'npx' 命令,它会自动下载并执行指定的 npm 包。

  1. 确保您已安装 Node.js 和 npm/npx。
  2. 您通常不需要手动构建,可以直接通过 'npx' 运行已发布的包。具体的包名称可以从项目的 'package.json' 或发布信息中找到(例如, README 中提及的 '@moralisweb3/api-mcp-server')。

服务器配置

此 MCP 服务器设计为由 MCP 客户端(如支持 MCP 的编辑器或应用)启动和管理。您需要在您的 MCP 客户端的配置中添加一个条目,告诉客户端如何启动和连接到此服务器。配置通常是一个 JSON 格式,至少包含以下关键信息:

  • 服务器名称: 一个您给服务器定义的唯一标识符(例如:"moralis")。
  • 启动命令 (command): 客户端用来启动服务器进程的命令行指令。例如,如果包名为 '@moralisweb3/api-mcp-server',命令可能是 'npx @moralisweb3/api-mcp-server'。
  • 启动参数 (args): 传递给启动命令的额外参数列表(通常为空数组 '[]')。
  • 环境变量 (env): 服务器运行所需的环境变量。最重要的环境变量是您的 Moralis API Key,通常需要配置一个名为 'MORALIS_API_KEY' 的变量,其值为您的密钥。

例如,在某些客户端的 MCP 配置中,可能会是类似这样的结构(具体格式请参考您使用的客户端文档):

{
  "mcpServers": {
    "moralis": {
      "command": "npx @moralisweb3/api-mcp-server",
      "args": [],
      "env": {
        "MORALIS_API_KEY": "您的实际Moralis API密钥"
      }
    }
  }
}

完成配置后,重启您的 MCP 客户端,客户端应该能够发现并连接到此 Moralis MCP 服务器。

基本使用方法

一旦 Moralis MCP 服务器在您的客户端配置中激活并成功连接,与该客户端集成的 LLM 就能够感知到服务器提供的 Moralis API 工具。

您可以通过与 LLM 自然语言对话的方式,请求它执行需要调用 Moralis API 的任务。例如:

  • “帮我查一下以太坊上地址 '0x...' 的所有ERC-20代币余额。”
  • “告诉我 Bored Ape Yacht Club 系列的最新十个销售记录。”
  • “这个交易哈希 '0x...' 的详细信息是什么?”

LLM 会识别出这些请求需要使用 Moralis API 工具,并代表您调用相应的工具函数。服务器会执行实际的 API 调用,并将结果返回给 LLM。LLM 再将获取到的数据以易于理解的方式呈现给您。

信息

分类

AI与计算