Ping MCP Server

Um servidor MCP que fornece ferramentas de IA on-chain para interação contínua com a blockchain Solana.

Documentação

Servidor MCP construído com o Ping Agent Kit

Um servidor Model Context Protocol (MCP) que oferece ferramentas onchain para IA, permitindo interação perfeita com a blockchain Solana por meio de uma interface padronizada. Construído com o Ping Agent Kit, esta implementação permite que agentes de IA executem operações de blockchain com eficiência.

Visão Geral

Este servidor MCP estende as capacidades do Claude fornecendo ferramentas para:

Interagir com a blockchain Solana
Executar transações
Consultar informações de contas
Gerenciar carteiras Solana

O servidor implementa a especificação Model Context Protocol para padronizar interações com blockchain para agentes de IA.

Pré-requisitos

Node.js (v16 ou superior)
pnpm (recomendado), npm ou yarn
Carteira Solana com chave privada
URL RPC da Solana (mainnet, testnet ou devnet)

Instalação

Opção 1: Instalar a partir do npm (recomendado para clientes como Cursor/Cline)

# Install globally
npm install -g ping-mcp

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

Opção 2: Compilar a partir do código-fonte

Clone este repositório:

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

Instale as dependências:

pnpm install

Compile o projeto:

pnpm run build

Configuração

Configuração do Ambiente

Crie um arquivo .env com suas credenciais:

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

Integração com o Claude Desktop

Para adicionar este servidor MCP ao Claude Desktop, siga estes passos:

Localize o Arquivo de Configuração do Claude Desktop
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Adicione a Configuração Crie ou edite o arquivo de configuração e adicione o seguinte JSON:

Se você instalou via npm (Opção 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": []
    }
  }
}

Se você compilou a partir do código-fonte (Opção 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": []
    }
  }
}

Reinicie o Claude Desktop Após fazer essas alterações, reinicie o Claude Desktop para que a configuração tenha efeito.

Estrutura do Projeto

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

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas de blockchain Solana:

GET_ASSET - Recuperar informações sobre um ativo/token Solana
DEPLOY_TOKEN - Implantar um novo token na Solana
GET_PRICE - Buscar informações de preço de tokens
WALLET_ADDRESS - Obter o endereço da carteira
BALANCE - Verificar saldo da carteira
TRANSFER - Transferir tokens entre carteiras
MINT_NFT - Criar e cunhar novos NFTs
TRADE - Executar negociações de tokens
REQUEST_FUNDS - Solicitar fundos (útil para testes/desenvolvimento)
RESOLVE_DOMAIN - Resolver nomes de domínio Solana
GET_TPS - Obter transações por segundo atuais na Solana

Considerações de Segurança

Mantenha sua chave privada segura e nunca a compartilhe
Use variáveis de ambiente para informações sensíveis
Considere usar uma carteira dedicada para operações de agentes de IA
Monitore e audite regularmente as atividades dos agentes de IA
Teste operações na devnet/testnet antes da mainnet

Solução de Problemas

Se você encontrar problemas:

Verifique se sua chave privada Solana está correta
Verifique se sua URL RPC está acessível
Certifique-se de estar na rede pretendida (mainnet, testnet ou devnet)
Verifique os logs do Claude Desktop para mensagens de erro
Verifique se a compilação foi bem-sucedida

Dependências

As principais dependências incluem:

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Faça um fork do repositório
Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add some amazing feature')
Envie para a branch (git push origin feature/amazing-feature)
Abra um Pull Request

Licença

Este projeto está licenciado sob a Licença MIT.