项目简介

Metaplex MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为 LLM 应用提供访问 Metaplex 相关信息的上下文服务。它通过 MCP 协议与客户端通信,提供了一系列工具来分析和验证 Metaplex 生态中的 NFT 配置和状态。

主要功能点

  • 分析 MPL-404 Recipe 配置 (analyze_recipe): 允许 LLM 分析 Metaplex 404 Recipe 的配置,例如最大/最小值、费用设置等,以验证其有效性。
  • 验证 MPL-404 Escrow 配置 (validate_escrow): 允许 LLM 验证 Metaplex 404 Escrow 合约的配置,检查其参数设置是否合理。
  • 计算 MPL-404 操作费用 (calculate_fees): 允许 LLM 预估 MPL-404 协议中 capture 或 release 操作的相关费用,包括 token 和 SOL 费用。
  • 检查 NFT/Token 转换状态 (check_conversion_status): 允许 LLM 查询特定 NFT 或 Token 的转换状态,判断其是否被锁定在 Escrow 合约中以及当前所有者信息。

安装步骤

  1. 克隆仓库到本地
    git clone https://github.com/aldrin-labs/metaplex-mcp-server.git
  2. 进入仓库目录
    cd metaplex-mcp-server
  3. 安装依赖
    npm install
  4. 构建项目
    npm run build
  5. 启动服务器
    node build/index.js
    或者,您可以使用以下命令在后台运行服务器:
    nohup node build/index.js > /dev/null 2>&1 &

服务器配置

为了让 MCP 客户端连接到 Metaplex MCP Server,您需要提供以下配置信息给客户端。客户端通常需要一个 JSON 格式的配置文件来指定 MCP 服务器的启动方式。

以下是一个示例配置,您需要根据实际情况修改 'args' 中的路径:

{
  "metaplex": { // server name:客户端使用此名称来识别和调用该 MCP 服务器
    "command": "node", // 启动服务器的命令,这里使用 Node.js 运行时
    "args": ["/path/to/metaplex-mcp-server/build/index.js"], // 启动命令的参数,指向构建后的 index.js 文件。请将 "/path/to/metaplex-mcp-server" 替换为实际的仓库路径。
    "env": {} // 环境变量,如果服务器运行需要特定的环境变量,可以在这里配置,本例中为空。
  }
}

注意: 请将 '/path/to/metaplex-mcp-server' 替换为 Metaplex MCP Server 仓库在您本地文件系统中的绝对路径

基本使用方法

  1. 确保 Metaplex MCP Server 已经成功启动并运行。
  2. 在 MCP 客户端中配置上述服务器配置信息,以便客户端能够找到并连接到 Metaplex MCP Server。
  3. 使用 MCP 客户端发送 MCP 请求,例如:
    • 使用 'ListToolsRequest' 获取服务器支持的工具列表。
    • 使用 'CallToolRequest' 调用特定的工具,例如 'analyze_recipe',并提供相应的参数(如 collection 地址)。
  4. 服务器将处理客户端请求,并返回 JSON-RPC 格式的响应,其中包含工具执行的结果或请求的数据。

例如,要使用 'analyze_recipe' 工具分析一个 Metaplex NFT Collection,您需要构造一个 'CallToolRequest',指定工具名称为 'analyze_recipe',并在 'arguments' 中提供 'collection' 地址。服务器将分析该 Collection 的 Recipe 配置,并将分析结果以 JSON 格式返回给客户端。

请参考 MCP 协议文档和 MCP 客户端的使用说明,了解如何发送和接收 MCP 请求和响应。

信息

分类

开发者工具