使用说明（Markdown 格式）

• 项目简介

  • tempo-mcp 是一个基于 MCP（Model Context Protocol）的后端服务器，旨在为 AI 代理提供 Tempo 区块链的上下文信息和能力，包括可读取的资源、可执行的工具以及可渲染的提示模板。服务器通过 JSON-RPC 与客户端通信，处理读取资源、调用工具、获取 Prompts 等请求，并返回标准化的 JSON-RPC 响应或通知。同时，它实现会话管理、能力声明及多传输协议支持，确保安全、可扩展的上下文服务。

• 主要功能点

  • 资源托管与数据访问：提供对区块链相关数据的统一访问入口，按资源 URI 或模式读取信息。
  • 工具注册与执行：注册可由 LLM 调用的工具，支持参数传递与结果返回。
  • Prompt 模板定义与渲染：提供可复用的对话模板，帮助生成一致的交互流程。
  • MCP 协议实现（JSON-RPC）：服务器接收客户端请求，返回标准化响应，支持通知与事件推送。
  • 会话与能力声明：对会话进行鉴权、限流、权限控制，并声明服务器能力。
  • 多传输协议支持：如 Stdio、SSE、WebSocket 等，便于不同环境的客户端接入。
  • 安全与审计：包含 spending 限额、地址白名单、访问密钥（会话密钥）及审计日志等安全特性。

• 安装步骤

  • 需要 Node.js 20 及以上版本及常用包管理工具（npm、pnpm、yarn）。
  • 下载源码后安装依赖并构建：
    • 安装依赖
    • 构建 TypeScript -> dist
  • 启动服务器
    • 直接运行：npx tempo-mcp
    • 或者全局安装后直接执行 tempo-mcp

• 服务器配置（MCP 客户端的连接信息）

  • 说明：MCP 客户端需要知道如何启动并连接到 MCP 服务器。下面给出一个示例配置项的描述，供 MCP 客户端在自己的配置中使用。请注意，这段信息属于客户端配置示例，服务器端不需要修改客户端配置。
  • 示例（.json 形式，仅作示例说明，非必须在服务端实现中出现）: { "server": { "name": "tempo", "command": "npx", "args": ["tempo-mcp"], "env": { "TEMPO_PRIVATE_KEY": "YOUR_PRIVATE_KEY", "TEMPO_RPC_URL": "https://rpc.testnet.tempo.xyz", "TEMPO_CHAIN_ID": "42429" } }, "notes": "以上配置用于 MCP 客户端在启动 MCP 服务器时指定启动命令和参数。客户端也可提供私钥、RPC 地址等环境变量以连接 Tempo 流程。" }

• 基本使用方法

  • 连接方式：通过 MCP 客户端发送 JSON-RPC 请求，服务器返回标准化的 JSON-RPC 响应或通知。
  • 常用操作示例（不涉及具体实现细节，便于理解流程）：
    • 读取资源信息，例如读取网络、账户、代币等上下文信息。
    • 调用工具，如查询余额、发起交易、执行合规检查等。
    • 获取 Prompt 模板以便与代理对话，渲染用于对话的上下文。
  • 运行后，开发者或 AI 代理即可向服务器发起 MCP 请求，服务器负责执行并返回结果，确保会话、限流和审计等安全约束。

• 注意事项

  • 根据 Tempo 测试网环境准备私钥和测试代币，避免真实资金风险。
  • 生产环境应配置 keystore / 外部签名等安全选项，并启用审计日志。
  • 如需在不同环境下接入，需调整 TEMPO_RPC_URL、TEMPO_CHAIN_ID、TEMPO_PRIVATE_KEY 等环境变量。

• 联系与支持

  • 该项目旨在实现 MCP 服务器端能力，若有 API 兼容性、稳定性或安全方面的改进需求，请参阅源代码中的实现文件及测试用例，提交问题或拉取请求以共同完善。