AI导哈

区块链交互工具

一个基于Ping Agent Kit构建的MCP服务器，为AI提供与Solana区块链无缝交互的工具，包括执行交易、查询账户信息和管理钱包等功能。

  • by PingAIFun
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pingaifun/ping-mcp

使用说明

使用Ping代理工具包构建的MCP服务器

模型上下文协议（MCP）服务器为AI提供链上工具，通过标准化接口与Solana区块链无缝交互。该实现基于Ping Agent Kit，允许AI代理高效执行区块链操作。

概述

此MCP服务器通过提供以下工具扩展了Claude的功能：

  • 与Solana区块链互动
  • 执行交易
  • 查询账户信息
  • 管理Solana钱包

服务器实现了模型上下文协议规范，以标准化AI代理的区块链交互。

先决条件

  • Node.js（v16或更高版本）
  • pnpm（推荐）、npm或yarn
  • 带私钥的Solana钱包
  • Solana RPC URL（主网、测试网或开发网）

安装

选项1：从npm安装（推荐给Cursor/Cline等客户端）

# Install globally
npm install -g ping-mcp

# Or install locally in your project
npm install ping-mcp

选项2：从源代码构建

  1. 克隆此存储库：
git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp
  1. 安装依赖项：
pnpm install
  1. 构建项目：
pnpm run build

配置

环境设置

创建一个 .env 使用您的凭据文件：

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # OPTIONAL

与Claude Desktop集成

要将此MCP服务器添加到Claude Desktop，请执行以下步骤：

  1. 找到Claude桌面配置文件

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json
    • Linux： ~/.config/Claude/claude_desktop_config.json

  2. 添加配置 创建或编辑配置文件，并添加以下JSON：

    如果你是通过npm安装的（选项1）：

    {
  "mcpServers": {
    "solana-mcp": {
      "command": "npx",
      "args": ["ping-mcp"],
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "SOLANA_PRIVATE_KEY": "your_private_key_here",
        "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

    如果您从源代码构建（选项2）：

    {
  "mcpServers": {
    "solana-mcp": {
      "command": "node",
      "args": ["/path/to/ping-mcp/build/index.js"],
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "SOLANA_PRIVATE_KEY": "your_private_key_here",
        "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

  3. 重新启动克劳德桌面 进行这些更改后，重新启动Claude Desktop以使配置生效。

项目结构

ping-agent-kit-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

可用工具

MCP服务器提供以下Solana区块链工具：

  • GET_ASSET -检索有关Solana资产/令牌的信息
  • DEPLOY_TOKEN -在Solana上部署新令牌
  • GET_PRICE -获取代币的价格信息
  • WALLET_ADDRESS -获取钱包地址
  • BALANCE -检查钱包余额
  • TRANSFER -在钱包之间转移代币
  • MINT_NFT -创建和创建新的NFT
  • TRADE -执行代币交易
  • REQUEST_FUNDS -申请资金（可用于测试/开发）
  • RESOLVE_DOMAIN -解析Solana域名
  • GET_TPS -获取Solana上每秒的当前交易量

安全考虑

  • 确保您的私钥安全，切勿共享
  • 对敏感信息使用环境变量
  • 考虑使用专用钱包进行AI代理操作
  • 定期监控和审计AI代理活动
  • 在主网之前在devnet/testnet上进行测试操作

故障排除

如果您遇到问题：

  1. 验证您的Solana私钥是否正确
  2. 检查您的RPC URL是否可访问
  3. 确保您在预期的网络（主网、测试网或开发网）上
  4. 检查Claude Desktop日志中的错误消息
  5. 验证构建是否成功

依赖项

关键依赖关系包括：

贡献

欢迎投稿！请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

该项目根据MIT许可证获得许可。

相关 MCP