Ping MCP Server

Un servidor MCP que proporciona herramientas de IA en cadena para una interacción fluida con la blockchain de Solana.

Documentación

Servidor MCP construido con el Ping Agent Kit

Un servidor de Protocolo de Contexto de Modelo (MCP) que ofrece herramientas onchain para IA, permitiendo una interacción fluida con la cadena de bloques de Solana a través de una interfaz estandarizada. Construido sobre el Ping Agent Kit, esta implementación permite a los agentes de IA ejecutar operaciones de blockchain de manera eficiente.

Resumen

Este servidor MCP extiende las capacidades de Claude proporcionando herramientas para:

Interactuar con la cadena de bloques de Solana
Ejecutar transacciones
Consultar información de cuentas
Gestionar carteras de Solana

El servidor implementa la especificación del Protocolo de Contexto de Modelo para estandarizar las interacciones con blockchain para agentes de IA.

Requisitos previos

Node.js (v16 o superior)
pnpm (recomendado), npm o yarn
Cartera de Solana con clave privada
URL RPC de Solana (mainnet, testnet o devnet)

Instalación

Opción 1: Instalar desde npm (recomendado para clientes como Cursor/Cline)

# Install globally
npm install -g ping-mcp

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

Opción 2: Compilar desde el código fuente

Clonar este repositorio:

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

Instalar dependencias:

pnpm install

Compilar el proyecto:

pnpm run build

Configuración

Configuración del entorno

Crea un archivo .env con tus credenciales:

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

Integración con Claude Desktop

Para añadir este servidor MCP a Claude Desktop, sigue estos pasos:

Localiza el archivo de configuración de 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

Añade la configuración Crea o edita el archivo de configuración y añade el siguiente JSON:

Si instalaste vía npm (Opción 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": []
    }
  }
}

Si compilaste desde el código fuente (Opción 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": []
    }
  }
}

Reinicia Claude Desktop Después de hacer estos cambios, reinicia Claude Desktop para que la configuración surta efecto.

Estructura del proyecto

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

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas de blockchain de Solana:

GET_ASSET - Recuperar información sobre un activo/token de Solana
DEPLOY_TOKEN - Desplegar un nuevo token en Solana
GET_PRICE - Obtener información de precios de tokens
WALLET_ADDRESS - Obtener la dirección de la cartera
BALANCE - Consultar el saldo de la cartera
TRANSFER - Transferir tokens entre carteras
MINT_NFT - Crear y acuñar nuevos NFTs
TRADE - Ejecutar operaciones de tokens
REQUEST_FUNDS - Solicitar fondos (útil para pruebas/desarrollo)
RESOLVE_DOMAIN - Resolver nombres de dominio de Solana
GET_TPS - Obtener transacciones por segundo actuales en Solana

Consideraciones de seguridad

Mantén tu clave privada segura y nunca la compartas
Usa variables de entorno para información sensible
Considera usar una cartera dedicada para operaciones de agentes de IA
Supervisa y audita regularmente las actividades de los agentes de IA
Prueba las operaciones en devnet/testnet antes de mainnet

Solución de problemas

Si encuentras problemas:

Verifica que tu clave privada de Solana sea correcta
Comprueba que tu URL RPC sea accesible
Asegúrate de estar en la red prevista (mainnet, testnet o devnet)
Revisa los registros de Claude Desktop para ver mensajes de error
Verifica que la compilación se haya realizado correctamente

Dependencias

Las dependencias clave incluyen:

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/amazing-feature)
Realiza tus cambios (git commit -m 'Add some amazing feature')
Empuja a la rama (git push origin feature/amazing-feature)
Abre un Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia MIT.