项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 AI 客户端（如支持 MCP 的 LLM 应用）提供与 Solana 区块链交互的能力。它通过注册一系列工具（Tools），使得 AI 代理能够执行链上操作，如查询资产信息、执行交易、管理钱包等，从而将 AI 的能力扩展到去中心化世界。

主要功能点

Solana 链上交互： 使 AI 能够理解并操作 Solana 区块链上的数据和功能。
提供多种工具： 封装了多种实用的 Solana 操作，例如：
- 获取代币或资产信息
- 部署新的代币
- 查询代币价格
- 获取钱包地址和余额
- 进行代币转账
- 铸造 NFT
- 执行链上交易
- 解析 Solana 域名
- 获取当前链上 TPS（每秒事务数）等。
遵循 MCP 协议： 以标准化的方式与 LLM 客户端通信，接收工具调用请求并返回结果。
支持多种传输方式： 支持 Stdio（标准输入输出）和 SSE（Server-Sent Events）等传输协议。

安装步骤

要安装此 MCP 服务器，您需要 Node.js (v16 或更高版本)。推荐使用 pnpm 包管理器，也可以使用 npm 或 yarn。

安装依赖： 如果您打算直接安装并运行：

# 全局安装 (推荐给客户端使用)
npm install -g ping-mcp

或者，如果您想在自己的项目中作为依赖安装：

# 本地安装
npm install ping-mcp

如果您想从源代码构建：

# 克隆仓库
git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp
# 安装依赖
pnpm install # 或 npm install, yarn install
# 构建项目
pnpm run build # 或 npm run build, yarn build

服务器配置

MCP 服务器本身需要一些基本的 Solana 连接信息才能运行。这些信息通常通过环境变量提供。而 MCP 客户端（如 Claude Desktop）需要知道如何启动这个服务器。

配置服务器运行环境： 创建 '.env' 文件，填入您的 Solana 私钥和 RPC URL。私钥用于签名链上交易，RPC URL 用于连接 Solana 网络。

SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
# 可选配置，如果您的工具需要 OpenAI API Key
OPENAI_API_KEY=your_openai_api_key

请务必保护您的私钥安全。

配置 MCP 客户端启动服务器： 您的 MCP 客户端（例如 Claude Desktop）需要一个配置文件来指定如何启动此 MCP 服务器。您需要在客户端的配置中添加一个条目，通常位于一个名为 'mcpServers' 的 JSON 对象中。这个条目会告诉客户端启动服务器所使用的命令 (command)、参数 (args) 以及需要的环境变量 (env)。

如果通过 npm 全局安装，启动命令通常是 'npx ping-mcp'。
如果从源代码构建，启动命令通常是 'node /path/to/your/ping-mcp/build/index.js' (请将 '/path/to/your/ping-mcp' 替换为实际路径)。

客户端配置示例结构（请参考您的客户端文档获取具体文件位置和格式，以下为概念说明，非实际代码）：

{
  "mcpServers": {
    "一个给服务器起的名字，比如 solana-mcp": {
      "command": "这里填写启动服务器的命令，如 'npx'",
      "args": [ "这里填写命令的参数，如 'ping-mcp'" ],
      "env": {
        "这里是服务器需要的环境变量": "对应的值，比如 SOLANA_PRIVATE_KEY 和 RPC_URL"
      },
      "disabled": false, // 是否启用此服务器
      "autoApprove": [] // 可选，配置自动批准的权限
    }
  }
}

请根据您的安装方式和实际路径，在客户端的配置文件中正确填写 'command', 'args', 和 'env' 信息。

基本使用方法

配置完成后，重启您的 MCP 客户端。客户端会根据配置启动 MCP 服务器。一旦服务器成功启动并连接，您的 AI 客户端就能够识别并利用服务器提供的 Solana 工具了。您可以通过向 AI 提问或发送指令的方式，让 AI 调用这些工具来执行 Solana 上的任务。例如，您可以尝试让 AI 查询某个代币的余额，或者发起一笔转账（请注意安全，并确认 AI 客户端的权限设置）。AI 客户端会负责将您的请求转化为 MCP 协议的调用发送给服务器，并处理服务器返回的结果。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息