MCP Server built with the Ping Agent Kit

A Model Context Protocol (MCP) server offering onchain tools for AI, enabling seamless interaction with the Solana blockchain via a standardized interface. Built on the Ping Agent Kit, this implementation allows AI agents to execute blockchain operations efficiently.

Overview

This MCP server extends Claude's capabilities by providing tools to:

Interact with Solana blockchain
Execute transactions
Query account information
Manage Solana wallets

The server implements the Model Context Protocol specification to standardize blockchain interactions for AI agents.

Prerequisites

Node.js (v16 or higher)
pnpm (recommended), npm, or yarn
Solana wallet with private key
Solana RPC URL (mainnet, testnet, or devnet)

Installation

Option 1: Install from npm ( recommend 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

Clone this repository:

git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp

Install dependencies:

pnpm install

Build the project:

pnpm run build

Configuration

Environment Setup

Create a .env file with your credentials:

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

Integration with Claude Desktop

To add this MCP server to Claude Desktop, follow these steps:

Locate the Claude Desktop Configuration File
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Add the ConfigurationCreate or edit the configuration file and add the following JSON:

If you installed via npm (Option 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": []
    }
  }
}

If you built from source (Option 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": []
    }
  }
}

Restart Claude DesktopAfter making these changes, restart Claude Desktop for the configuration to take effect.

Project Structure

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

Available Tools

The MCP server provides the following Solana blockchain 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 (useful for testing/development)
RESOLVE_DOMAIN - Resolve Solana domain names
GET_TPS - Get current transactions per second on Solana

Security Considerations

Keep your private key secure and never share it
Use environment variables for sensitive information
Consider using a dedicated wallet for AI agent operations
Regularly monitor and audit AI agent activities
Test operations on devnet/testnet before mainnet

Troubleshooting

If you encounter issues:

Verify your Solana private key is correct
Check your RPC URL is accessible
Ensure you're on the intended network (mainnet, testnet, or devnet)
Check Claude Desktop logs for error messages
Verify the build was successful

Dependencies

Key dependencies include:

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License.

MCP Server built with the Ping Agent Kit