使用说明（简要可操作版）

• 项目简介

  • 这是一个基于 MCP（Model Context Protocol）的后端服务器，用于向 MCP 客户端提供对 Proton 区块链（XPR 网络）的工具、数据查询能力，并支持可扩展的部署方式（包括 Azure Functions）。

• 主要功能点

  • MCP 服务器核心：实现初始化、工具列表查询（tools/list）与工具调用（tools/call）的 JSON-RPC 处理，以及通过 MCP 客户端获取并返回工具执行结果。
  • 工具库覆盖多类区块链数据与操作：链信息、账户、区块、交易、表数据查询、合约 ABI、区块生产者等，便于 LLM 调用外部功能。
  • 部署与扩展能力：支持独立 MCP 服务器运行，以及通过 Azure Functions 部署的 REST/HTTP 端点形式提供服务。
  • 兼容性与扩展性：工具集合来源于各类区块链适配器，未来可按需扩展新工具集（NFT、交易历史、DEX 代币等）。

• 安装步骤

  • 下载代码后在项目根目录执行：
    • 安装依赖：npm install
    • 启动服务器（本地开发/测试）：npm start
  • 如需使用 Azure Functions，请按照仓库中的对应指南进行本地开发环境搭建与运行。

• 服务器配置（供 MCP 客户端使用的启动信息）

  • 服务器名称：xpr-mcp-server
  • 启动命令（命令英文注释）
    • command: node
    • args: src/index.js
  • 说明
    • 该配置用于 MCP 客户端在需要连接到服务器端时，明确服务器名称与执行入口。客户端不需要包含在此处。

• 基本使用方法

  • 启动后，客户端可通过 JSON-RPC 调用以下核心方法：
    • initialize：初始化服务器能力与信息
    • tools/list：获取可用工具的列表（名称、描述、输入 schema）
    • tools/call：按名称执行具体工具，返回文本内容形式的结果
  • 示例流程（简述）
    • 发送 initialize 请求，获取服务器能力信息
    • 发送 tools/list，了解支持的工具
    • 发送 tools/call，传入工具名与参数，LLM/客户端将收到文本格式的结果文本

• 其他注意

  • 服务器内部分离了工具实现与暴露的 MCP 接口，未来扩展可在工具注册处增加新工具或扩展现有工具的输入输出结构。
  • 部署时如需 Azure Functions，请参考仓库中的 Azure 部署脚本与函数端点配置。