Morpho API MCP 服务器使用说明

项目简介

Morpho API MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为 LLM (大型语言模型) 客户端提供访问 Morpho 协议数据的能力。通过此服务器，LLM 客户端可以查询 Morpho 市场的实时和历史数据，包括市场信息、金库状态、用户持仓、交易记录等，从而增强 LLM 在 DeFi (去中心化金融) 领域的应用能力。

主要功能点

市场数据查询: 提供多种工具用于检索 Morpho 市场的详细信息，包括市场列表、白名单市场、市场持仓、历史 APY (年化收益率) 数据和预言机信息。
金库数据查询: 支持查询 Morpho 金库的相关数据，如金库列表、金库持仓、金库交易记录、金库资产分配、金库重新分配历史和金库 APY 历史数据。
资产和账户数据查询: 允许查询特定资产的价格和收益信息，以及账户的概览信息，包括持仓和交易记录，还支持查询清算事件。
分页、排序和过滤: 大多数数据查询工具都支持分页、排序和过滤参数，方便 LLM 客户端灵活地获取所需数据。
数据验证: 使用 Zod 库对从 Morpho API 获取的数据进行严格的模式验证，确保数据质量和类型安全。
错误处理: 提供完善的错误处理机制，当数据请求或工具调用失败时，能够返回清晰的错误信息。
MCP 兼容性: 完全遵循 Model Context Protocol 标准实现，可以与任何兼容 MCP 协议的 LLM 客户端无缝集成。

安装步骤

安装 npm 包: 在你的项目目录下，使用 npm 安装 'mcp-morpho-server' 包：

npm install mcp-morpho-server

服务器配置

要将 Morpho API MCP 服务器添加到兼容 MCP 协议的 LLM 客户端（例如 Claude Desktop），你需要配置一个工具项。以下是一个示例配置，你需要根据你的实际环境调整路径：

{
  "tools": {
    "morpho": {
      "serverName": "morpho-api-server",  // MCP 服务器名称，可自定义
      "command": "node",
      "args": [
        "/path/to/node_modules/mcp-morpho-server/build/index.js" // 指向服务器入口文件 index.js 的路径，根据实际安装位置修改
      ]
    }
  }
}

配置参数说明:

'"serverName"': MCP 服务器的名称，用于在客户端配置中标识该服务器，可以自定义。
'"command"': 启动 MCP 服务器的命令，这里使用 'node' 表示使用 Node.js 运行。
'"args"': 传递给启动命令的参数，这里指向 'mcp-morpho-server' 包的入口文件 'build/index.js'。你需要将 '/path/to/node_modules' 替换为你的 'node_modules' 目录的实际路径。

基本使用方法

Morpho API MCP 服务器被设计为由 LLM 客户端（如 Claude）自动调用。一旦你按照上述步骤配置好服务器，LLM 客户端就可以根据用户的指令，通过调用服务器提供的工具来查询 Morpho 协议的数据。

例如，如果用户向 LLM 客户端询问 "当前 DAI 市场的供应 APY 是多少？"，客户端可能会调用 'get_markets' 工具，并根据返回的市场数据找到 DAI 市场并提取供应 APY 信息，最终以自然语言回复用户。用户无需直接与 MCP 服务器交互，所有的操作都由 LLM 客户端在后台自动完成。

可用工具列表

以下是 Morpho API MCP 服务器提供的工具及其简要描述：

'get_markets': 检索所有 Morpho 市场，支持分页和过滤。
'get_whitelisted_markets': 仅检索白名单中的 Morpho 市场。
'get_market_positions': 获取特定市场的持仓概览。
'get_historical_apy': 获取特定市场的历史 APY 数据。
'get_oracle_details': 获取特定市场的预言机详细信息。
'get_vaults': 检索所有 Morpho 金库及其当前状态。
'get_vault_positions': 获取特定金库的持仓信息。
'get_vault_transactions': 获取金库的交易历史记录。
'get_vault_allocation': 获取金库的市场资产分配情况。
'get_vault_reallocates': 获取金库的重新分配历史记录。
'get_vault_apy_history': 获取金库的历史 APY 数据。
'get_asset_price': 获取特定资产的当前价格和收益信息。
'get_account_overview': 获取账户的概览信息，包括市场和金库持仓以及交易记录。
'get_liquidations': 获取清算事件信息。

每个工具的具体输入参数和返回数据结构请参考代码中的 'inputSchema' 和 Response Schema 定义。

关键词

Morpho API MCP 服务器使用说明

信息