使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器，专门为大型语言模型（LLM）设计，旨在帮助LLM理解Stellar区块链上的交易数据。它提供了一系列工具，可以将Stellar特有的XDR (External Data Representation) 格式的数据转换为LLM更容易理解的JSON格式。

主要功能点

XDR类型猜测: 允许LLM猜测一段XDR数据可能代表的Stellar数据类型。
XDR解码为JSON: 将指定类型的XDR数据解码为JSON格式，方便LLM解析和理解数据内容。
交易XDR解码: 专门用于将Stellar交易相关的XDR数据解码为JSON格式。

总而言之，该服务器为LLM提供了理解Stellar区块链数据的桥梁，通过工具将复杂的XDR数据转换成结构化的JSON，使得LLM可以更好地处理和分析Stellar网络上的信息。

安装步骤

本仓库无需安装步骤，因为它是一个可以直接运行的Deno脚本。您只需确保您的MCP客户端（如Claude）可以访问到该脚本的URL即可。

服务器配置

要将此MCP服务器配置到您的MCP客户端（例如Claude Desktop或Claude Code），您需要提供服务器的启动命令和参数。以下是针对不同客户端的配置示例：

Claude Desktop 配置 (macOS/Windows)

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'，该文件通常位于：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
在 'mcpServers' 字段中添加一个新的服务器配置项，例如 "stellar-mcp"。配置信息如下：

{
  "mcpServers": {
    "stellar-mcp": {
      "command": "npx",
      "args": [
        "deno",
        "run",
        "--allow-read",
        "https://github.com/leighmcculloch/stellar-mcp-xdr-json/raw/refs/heads/main/stellar-mcp-xdr-json.ts"
      ]
    }
  }
}

参数解释:

'command': 指定启动服务器的命令，这里使用 'npx' 来运行 'deno'。
'args': 启动命令的参数列表：
- 'deno': 使用 Deno 运行时环境。
- 'run': Deno 的 'run' 命令，用于执行脚本。
- '--allow-read': 允许 Deno 脚本读取文件，尽管此脚本是从URL加载，但为了保险起见，添加此权限。
- 'https://github.com/leighmcculloch/stellar-mcp-xdr-json/raw/refs/heads/main/stellar-mcp-xdr-json.ts': 服务器脚本的直接URL，指向 GitHub 仓库中的 'stellar-mcp-xdr-json.ts' 文件。

Claude Code 配置

使用 Claude Code 命令行工具添加 MCP 服务器配置：

claude mcp add \
  --transport stdio \
  --scope user \
  stellar-mcp-xdr-json \
  -- \
  npx deno run --allow-read https://github.com/leighmcculloch/stellar-mcp-xdr-json/raw/refs/heads/main/stellar-mcp-xdr-json.ts

参数解释:

'claude mcp add': Claude Code 命令行工具的添加 MCP 服务器命令。
'--transport stdio': 指定使用标准输入输出 (stdio) 作为传输协议。
'--scope user': 配置作用域为用户级别。
'stellar-mcp-xdr-json': 服务器名称，在 Claude Code 中用于标识该服务器。
'--': 分隔 Claude Code 命令参数和服务器启动命令参数。
后续参数与 Claude Desktop 配置中的 'args' 相同，用于指定如何启动服务器脚本。

配置完成后，重启 Claude Desktop 或 Claude Code 使配置生效。

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude）应该能够检测到 "stellar-mcp" 服务器提供的工具。当LLM需要理解Stellar XDR数据时，它可以调用此服务器提供的工具，例如：

当LLM遇到一段Base64编码的XDR数据，但不确定其类型时， 可以调用 'xdr_guess' 工具，并提供XDR数据作为参数。服务器将返回可能的XDR类型列表。
当LLM已知XDR数据的类型，并需要解码为JSON时， 可以调用 'xdr_decode' 工具，并提供 XDR 数据和类型名称作为参数。服务器将返回解码后的JSON数据。
当处理Stellar交易相关的XDR数据时， 可以直接调用 'xdr_decode_transaction' 工具，并提供交易 XDR 数据。服务器将返回交易的JSON表示。

LLM客户端会根据服务器提供的工具描述和参数定义，自动构建请求并发送到服务器，然后解析服务器返回的JSON结果，从而理解Stellar区块链数据。

关键词