Ping

A Model Context Protocol server that facilitates interaction with the Solana blockchain, built using the Ping Agent Kit. (https://github.com/PingAIFun/ping-agent-kit)

shell

1

GitHub Stars

shell

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pingaifun-ping-mcp": {
      "command": "npx",
      "args": [
        "ping-mcp"
      ],
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "OPENAI_API_KEY": "your_openai_api_key",
        "SOLANA_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

You run a Solana MCP server built to expose onchain tools to AI agents. It standardizes interactions like querying accounts, managing wallets, and executing transactions, enabling seamless AI-powered blockchain operations.

How to use

Connect an MCP client to the Ping MCP Server to access Solana tools through a consistent interface. You can run the server locally and point your client to either a local process or a remote MCP endpoint. Use the provided environments to supply your Solana private key and RPC URL, and optionally the OpenAI API key for agent interactions.

How to install

Prerequisites: you need Node.js v16 or higher and a package manager such as npm, pnpm, or yarn. You also require a Solana wallet private key and a Solana RPC URL.

# Option 1: Install from npm (recommended for clients like Cursor/Cline)
# Install globally
npm install -g ping-mcp

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

Option 2: Build from Source Follow these steps to build and run from source.

# 1. Clone the repository
git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp

# 2. Install dependencies
pnpm install

# 3. Build the project
pnpm run build

Additional configuration and notes

Create a configuration file with your credentials and integration details. You will provide your Solana private key and RPC URL, and you may include an OpenAI API key for AI-driven workflows.

Configuration and start guidance

To run or integrate the MCP server with Claude Desktop, you configure two MCP options. You can either run the server via npx for a quick start or run the built index.js for a local build.

Security and maintenance

Keep your private keys secure and avoid sharing them. Use environment variables for sensitive information and monitor agent activities regularly. Test operations on devnet/testnet before engaging mainnet.

Troubleshooting

If you encounter issues, verify your private key and RPC URL, ensure you are on the correct network, check client logs for errors, and confirm the server process started correctly.

Notes on available tools

The server exposes a set of Solana-related tools for AI agents to perform actions such as retrieving asset information, deploying tokens, querying balances, transferring funds, minting NFTs, and more.

Available tools

GET_ASSET

Retrieve information about a Solana asset/token

DEPLOY_TOKEN

Deploy a new token on Solana

GET_PRICE

Fetch price information for tokens

WALLET_ADDRESS

Get the wallet address

BALANCE

Check wallet balance

TRANSFER

Transfer tokens between wallets

MINT_NFT

Create and mint new NFTs

TRADE

Execute token trades

REQUEST_FUNDS

Request funds for development/testing

RESOLVE_DOMAIN

Resolve Solana domain names

GET_TPS

Get current transactions per second on Solana