项目简介

Ping MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，专门设计用于连接大型语言模型 (LLM) 应用与 Solana 区块链。通过实现标准的 MCP 协议，Ping MCP 允许 LLM 客户端以结构化的方式访问 Solana 上的数据、执行交易等操作，从而为构建智能化的区块链应用提供了桥梁。

主要功能点

• Solana 交互能力: 提供丰富的工具，允许LLM执行与Solana区块链相关的操作，例如：
  • 查询资产信息
  • 部署代币
  • 获取代币价格
  • 查询钱包地址和余额
  • 查看代币余额
  • 发送代币或NFT
  • 铸造NFT
  • 执行交易
  • 请求测试网资金 (Airdrop)
  • 解析Solana域名
  • 获取网络TPS (每秒交易量)
• MCP 标准支持: 实现MCP协议，通过标准化的JSON-RPC接口与LLM客户端通信。
• 多种传输协议: 支持通过Stdio（标准输入输出）和SSE (Server-Sent Events) 两种方式与客户端建立连接和交换信息。
• 易于部署和使用: 基于Node.js环境，安装和启动流程简单。

安装步骤

1. 克隆仓库: 将项目代码克隆到本地：

   git clone https://github.com/leomrodrigues/ping-mcp.git
   

2. 进入项目目录:

   cd ping-mcp
   

3. 安装依赖: 使用npm安装项目所需的全部依赖包：

   npm install
   

4. 配置环境: 在项目根目录创建一个名为 '.env' 的文件。参考 '.env.example' 文件，在 '.env' 中配置连接Solana网络和必要密钥的信息。至少需要配置：

   • 'SOLANA_PRIVATE_KEY': 您的Solana钱包私钥（Base58编码）。
   • 'RPC_URL': 连接的Solana RPC节点的URL。
   • 'OPENAI_API_KEY': (可选) 如果某些功能依赖OpenAI服务则需要配置。
   • 'PORT': (可选) 如果希望通过SSE方式运行服务器并指定端口，则设置此项。不设置则默认使用Stdio方式。

5. 启动服务器: 运行以下命令启动MCP服务器：

   npm start
   

   服务器将根据 '.env' 中是否设置 'PORT' 来决定使用Stdio还是SSE模式启动。

服务器配置（供MCP客户端参考）

MCP客户端需要配置如何启动并连接到此服务器。以下是客户端通常需要知道的关键信息：

• 服务器名称 (serverName): 'solana-agent'
• 启动命令 (command): 启动此服务器进程的命令。如果在项目根目录执行，通常是 'npm'。
• 启动参数 (args): 传递给启动命令的参数。对于 'npm start'，参数通常是 'start'。完整的启动命令即为 'npm start'。
• 环境变量 (env): 启动服务器进程时必须设置的环境变量，包括 'SOLANA_PRIVATE_KEY', 'RPC_URL'，以及可选的用于SSE模式的 'PORT'。客户端需要在其配置中提供这些环境变量的值，以便启动服务器时传递给它。

客户端配置示例（概念性，非代码）： 客户端的配置文件或界面中，会指定服务器名称为 'solana-agent'，启动命令为 'npm'，参数为 'start'，并提供必需的环境变量 'SOLANA_PRIVATE_KEY' 和 'RPC_URL' 的值，如果使用SSE模式还需要提供 'PORT' 的值。客户端框架会负责使用这些信息启动一个独立的服务器进程并通过Stdio或SSE与其通信。

基本使用方法

一旦服务器启动，MCP客户端（如支持MCP协议的LLM应用或Agent框架）即可连接。客户端会发现服务器提供的能力（资源和工具），然后可以通过发送JSON-RPC请求来调用这些能力。

例如，LLM Agent可能会通过MCP向服务器发送一个请求，要求查询某个Solana地址的余额，服务器处理请求并返回结果。或者，LLM Agent可能会请求执行一个代币转账工具，服务器会执行相应的Solana交易操作。

用户无需直接与服务器的Stdio或SSE端点交互，而是通过支持MCP协议的LLM客户端应用进行自然语言交流，客户端负责将用户的意图转化为MCP请求发送给Ping MCP服务器。