项目简介

本项目是一个遵循 Model Context Protocol (MCP) 标准的服务器实现，专为大型语言模型（如Claude）设计。它通过暴露一组工具，使得LLM能够处理Stellar网络中的Extensible Data Representation (XDR) 格式数据，将其转换为更易于理解的JSON格式。这极大地增强了LLM在分析和解释Stellar交易、事件等方面的能力。

主要功能点

该MCP服务器提供了以下核心功能（工具）：

1. xdr_guess: 猜测给定的Stellar XDR数据的可能类型列表。
2. xdr_decode: 将指定类型的Stellar XDR数据解码为JSON格式。
3. xdr_decode_transaction: 特别针对Stellar交易（TransactionEnvelope）的XDR数据进行解码并转换为JSON格式。

LLM客户端在需要理解或处理Stellar XDR数据时，可以自动调用这些工具。

安装步骤

该服务器项目使用 Deno 作为运行时环境。

1. 确保你的系统上安装了 Deno。
2. 服务器本身是一个可直接运行的 Deno 脚本，无需额外的安装步骤。LLM客户端会通过配置指定的命令来启动它。

服务器配置

MCP 服务器需要通过 MCP 客户端（如 Claude Desktop 或 Claude Code）进行配置和启动。配置信息通常以 JSON 格式存储，指定服务器的名称、启动命令和参数。

以下是配置该服务器所需的关键信息：

• 服务器名称 (server name)：'mcp-stellar-xdr-json'
• 启动命令 (command)：'npx' (或者直接是你的 Deno 可执行文件路径，如果 npx 配置有问题)
• 命令参数 (args)：
  • 'deno'
  • 'run'
  • '--allow-read' (允许读取文件，脚本可能需要此权限)
  • 'https://github.com/leighmcculloch/mcp-stellar-xdr-json/raw/refs/heads/main/mcp-stellar-xdr-json.ts' (服务器脚本的URL)

具体的配置方式取决于你使用的MCP客户端。例如，对于某些客户端，你可能需要编辑一个 JSON 文件或使用命令行工具添加配置。请参考你的MCP客户端文档获取详细的配置方法。

基本使用方法

一旦服务器在MCP客户端中配置并启动成功，LLM就能够感知并使用其提供的工具。

1. 在支持 MCP 的 LLM 客户端中，向模型提供需要解析的 Stellar XDR 数据（通常是 Base64 编码的字符串）。
2. 模型会自动识别这些数据，并根据情况调用 'xdr_guess' 工具来识别数据类型，或调用 'xdr_decode' / 'xdr_decode_transaction' 工具来将其解码为 JSON。
3. 解码后的 JSON 数据会被返回给模型，帮助它进一步分析和理解。

例如，你可以提供一个 Stellar 交易的 Base64 编码 XDR 字符串，并询问模型这是什么交易，模型就可能自动调用相应的工具进行解码并向你解释 JSON 内容。