项目简介

'awesome-radix-mcp-servers' 是一个精选的 Model Context Protocol (MCP) 服务器实现集合,专注于 Radix DLT 生态系统。它包含了多个独立的服务器项目,每个项目都集成了 Radix 生态中的特定平台或服务,并通过 MCP 协议将这些能力暴露给支持 MCP 的大型语言模型 (LLM) 客户端。这些服务器使用官方的 '@modelcontextprotocol/sdk' 开发,确保符合协议标准。

主要功能点

本项目集合中的服务器主要提供以下类型的能力,作为 LLM 可调用的工具:

  • 数据获取与整合: 集成 Radix 生态中的应用平台(如 DeFi 协议 Attos World),获取实时或历史数据,如流动性池信息、APY 等。
  • 实用工具函数: 提供与 Radix 链上操作或数据相关的实用功能,如根据包地址生成链上结构的 Schema 信息(由 SBOR EZ Mode 集成提供)。
  • 上下文提供: 将获取到的结构化或非结构化数据转化为 LLM 可理解和利用的上下文信息,辅助 LLM 进行问答、分析或执行任务。

每个服务器都通过标准的 MCP JSON-RPC 协议与客户端通信,通常支持 Stdio 等传输方式。

安装步骤

由于这是一个集合仓库,你需要进入到你想运行的具体服务器子目录进行安装和构建。

  1. 克隆仓库:
    git clone https://github.com/xstelea/awesome-radix-mcp-servers.git
    cd awesome-radix-mcp-servers
  2. 进入目标服务器目录: 例如,要运行 Attos World 服务器:
    cd mcp-servers/attos-world
    或 SBOR EZ Mode 服务器:
    cd mcp-servers/sbor-ez-mode
  3. 安装依赖: 确保你已安装 Node.js 和 npm 或 yarn。
    npm install
    # 或 yarn install
  4. 构建项目: 这将编译 TypeScript 代码。
    npm run build
    构建成功后,可执行文件通常会生成在 'dist' 目录下。

服务器配置 (供 MCP 客户端使用)

MCP 客户端需要知道如何启动 MCP 服务器进程并与其通信。以下是此仓库中包含的两个服务器的典型配置信息,供 MCP 客户端参考:

Attos World MCP 服务器配置示例:

  • 名称 (name): 'attos-world'
  • 启动命令 (command): 'node'
  • 命令参数 (args): '["dist/index.js"]'
  • 说明: 客户端应执行 'node dist/index.js' 命令来启动此服务器。请确保命令在其运行环境中能够找到 'node' 可执行文件,且 'dist/index.js' 文件路径相对于客户端启动服务器时的当前工作目录是正确的(通常建议客户端在服务器的安装目录下启动进程)。

SBOR EZ Mode MCP 服务器配置示例:

  • 名称 (name): 'sbor-ez-mode'
  • 启动命令 (command): 'node'
  • 命令参数 (args): '["dist/index.js"]'
  • 说明: 客户端应执行 'node dist/index.js' 命令来启动此服务器。请确保命令在其运行环境中能够找到 'node' 可执行文件,且 'dist/index.js' 文件路径相对于客户端启动服务器时的当前工作目录是正确的(通常建议客户端在服务器的安装目录下启动进程)。

重要提示: 在使用上述配置之前,请确保你已经完成了安装步骤,并且服务器代码已经成功构建 ('npm run build')。

基本使用方法

一旦 MCP 服务器安装并构建完成,且你的 MCP 客户端已配置正确的启动命令和参数:

  1. 启动你的 MCP 客户端。
  2. 客户端应根据配置自动启动相应的 Radix MCP 服务器进程。
  3. 客户端会通过 MCP 协议与服务器建立连接,并获取服务器的能力声明(Capability Declaration),其中包括服务器提供的工具列表及其描述和参数。
  4. LLM 客户端现在可以根据需要调用服务器提供的工具。例如:
    • 调用 'attos-world' 服务器的 'get-attos-earn-pools' 工具来获取 Attos 平台的流动性池数据。
    • 调用 'sbor-ez-mode' 服务器的 'generate schema' 工具,提供一个 Radix 包地址作为参数,以获取对应的链上 Schema 信息。
  5. 服务器执行工具并将结果通过 MCP 协议返回给客户端,LLM 即可利用这些信息。

信息

分类

AI与计算