使用说明

• 项目简介

  • 该仓库实现了一个 MCP 服务器，用于 PumpClaw 的 Base 主网环境。服务器提供了对资源的托管、工具的注册与执行，以及可渲染的 Prompt 模板等 MCP 核心能力。客户端（如 Claude、GPT 等 MCP Agent）可以通过 JSON-RPC 方式与该服务器对接，获取上下文信息、调用工具以部署代币、查询 Token 列表等。当前实现采用标准的 Stdio 传输作为 MCP 服务器的通信通道，便于在命令行/管道环境中对接。

• 主要功能点

  • MCP 核心能力
    • Resource（资源）托管：定义并提供协议信息等上下文资源，便于 LLM 客户端获取系统信息与上下文。
    • Tools（工具）：注册并实现对外部功能的调用，如列出代币、获取代币信息、部署代币等。
    • Prompts（提示模板）：提供可渲染的 Prompt 相关信息，帮助 LLM 客户端以标准化方式获取上下文与指令。
  • 服务实现要点
    • 服务器通过 MCP 规范的 JSON-RPC 请求/响应进行通信。
    • 部署令牌需要私钥签名，且写入操作需要具备钱包签名能力（BASE_PRIVATE_KEY 环境变量）。
    • 提供只读工具（list_tokens、get_token、get_stats）以及写操作工具（deploy_token）。
  • 运行方式
    • 使用 Node 运行 mcp-server/dist/index.js，或将源码编译后执行搭建到相应运行环境。
    • 服务基于 stdio 服务传输进行通信，便于与任何遵循 MCP 的客户端进行对接。

• 安装步骤

  • 安装依赖并构建（如使用 npm/yarn）
  • 确保环境变量配置正确，尤其 BASE_PRIVATE_KEY（用于写操作/部署）
  • 启动 MCP 服务器
    • node mcp-server/dist/index.js

• 服务器配置（MCP 客户端配置示例，JSON，供客户端连接时读取）

  • 服务器名称: pumpclaw
  • 启动命令: npx pumpclaw-mcp
  • 启动参数: []（根据具体运行环境可追加参数）
  • 说明：MCP 客户端需要提供 server name、command、args 等字段以连接指定 MCP 服务器。以下为示例配置，不作为代码块出现，仅作描述性注释：
  • serverName: "pumpclaw"
  • command: "npx pumpclaw-mcp"
  • args: []
  • 注释：PumpClaw 的 MCP 服务器默认通过 npx pumpclaw-mcp 启动，写入令牌部署需要 BASE_PRIVATE_KEY 环境变量。

• 基本使用方法

  • 启动服务器后，MCP 客户端即可通过 JSON-RPC 方式对服务器发起请求：
    • 调用 list_tokens 获取已部署代币列表
    • 调用 get_token 获取单个代币信息
    • 调用 get_stats 获取整体协议统计
    • 调用 deploy_token 部署新的代币（需具备私钥并提供 token 参数）
  • 部署前请确保环境变量 BASE_PRIVATE_KEY 已正确设置，服务器具备签名部署代币所需的钱包能力。
  • 客户端可通过 MCP 标准的流程将资源、工具和 Prompts 集成到自定义的对话流程中，实现对 PumpClaw 的上下文化访问与自动化部署。

• 注意事项

  • 当前实现以 Stdio 传输作为 MCP 服务器通道，若需扩展到 SSE/WebSocket 传输，请参考相应的 MCP 服务器接入扩展。
  • 写操作需要私钥签名，请确保私钥的安全性与权限管理。