项目简介
这是一个基于 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 包。
- 确保您已安装 Node.js 和 npm/npx。
- 您通常不需要手动构建,可以直接通过 '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与计算