Solana MCP Server

Servidor MCP creado con el kit de agente Ping

Un servidor de Protocolo de Contexto de Modelo (MCP) que ofrece herramientas en cadena para IA, lo que permite una interacción fluida con la blockchain de Solana mediante una interfaz estandarizada. Basada en el Kit de Agente Ping, esta implementación permite a los agentes de IA ejecutar operaciones de blockchain de forma eficiente.

Descripción general

Este servidor MCP amplía las capacidades de Claude al proporcionar herramientas para:

• Interactuar con la cadena de bloques de Solana
• Ejecutar transacciones
• Consultar información de la cuenta
• Administrar billeteras Solana

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

Prerrequisitos

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

Instalación

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

Opción 2: Construir desde la fuente

1. Clonar este repositorio:

2. Instalar dependencias:

3. Construir el proyecto:

Configuración

Configuración del entorno

Crea un archivo .env con tus credenciales:

Integración con Claude Desktop

Para agregar este servidor MCP a Claude Desktop, siga estos pasos:

1. Localice el archivo de configuración de Claude Desktop
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Agregar la configuración Cree o edite el archivo de configuración y agregue el siguiente JSON:Si lo instaló mediante 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 lo compiló desde la 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": [] } } }
3. Reiniciar Claude Desktop Después de realizar estos cambios, reinicie Claude Desktop para que la configuración surta efecto.

Estructura del proyecto

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 - Implementar un nuevo token en Solana
• GET_PRICE - Obtener información de precios de los tokens
• WALLET_ADDRESS - Obtener la dirección de la billetera
• BALANCE - Consultar el saldo de la billetera
• TRANSFER - Transferir tokens entre billeteras
• MINT_NFT - Crea y acuña nuevos NFT
• TRADE - Ejecutar intercambios de tokens
• REQUEST_FUNDS - Solicitar fondos (útil para pruebas/desarrollo)
• RESOLVE_DOMAIN - Resolver nombres de dominio de Solana
• GET_TPS - Obtener las transacciones actuales por segundo en Solana

Consideraciones de seguridad

• Mantenga su clave privada segura y nunca la comparta
• Utilice variables de entorno para información confidencial
• Considere usar una billetera dedicada para las operaciones del agente de IA
• Supervisar y auditar periódicamente las actividades de los agentes de IA
• Operaciones de prueba en devnet/testnet antes de mainnet

Solución de problemas

Si encuentra problemas:

1. Verifique que su clave privada de Solana sea correcta
2. Comprueba que tu URL de RPC sea accesible
3. Asegúrese de estar en la red deseada (red principal, red de prueba o red de desarrollo)
4. Consulte los registros de Claude Desktop para ver si hay mensajes de error
5. Verificar que la compilación fue exitosa

Dependencias

Las dependencias clave incluyen:

• @solana/web3.js
• @modelcontextprotocol/sdk
• kit de agente de ping

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio
2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.