Solana Agent Kit MCP Server

Interactúa con la blockchain de Solana usando el Solana Agent Kit.

Documentación

Servidor MCP de Solana Agent Kit

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas onchain para Claude AI, permitiéndole interactuar con la blockchain de Solana a través de una interfaz estandarizada. Esta implementación se basa en el Solana Agent Kit y permite a los agentes de IA realizar operaciones blockchain sin problemas.

Resumen

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

Interactuar con la blockchain de Solana
Ejecutar transacciones
Consultar información de cuentas
Gestionar billeteras de Solana

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

Requisitos previos

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

Instalación

Opción 1: Instalación rápida (Recomendada)

# Download the installation script
curl -fsSL https://raw.githubusercontent.com/sendaifun/solana-mcp/main/scripts/install.sh -o solana-mcp-install.sh

# Make it executable and run
chmod +x solana-mcp-install.sh && ./solana-mcp-install.sh --backup

Esto iniciará un proceso de instalación interactivo que te guiará a través de:

Configuración de Node.js si es necesario
Configuración de tu URL RPC de Solana y clave privada
Configuración de la integración con Claude Desktop

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

# Install globally
npm install -g solana-mcp

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

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

Clona este repositorio:

git clone https://github.com/sendaifun/solana-mcp
cd solana-mcp

Instala las dependencias:

pnpm install

Compila 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 agregar 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

Agrega la configuración Crea o edita el archivo de configuración y agrega el siguiente JSON:

Si instalaste vía npm (Opción 1):

{
  "mcpServers": {
    "solana-mcp": {
      "command": "npx",
      "args": ["solana-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/solana-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 realizar estos cambios, reinicia Claude Desktop para que la configuración surta efecto.

Estructura del proyecto

solana-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 para tokens
WALLET_ADDRESS - Obtener la dirección de la billetera
BALANCE - Verificar el saldo de la billetera
TRANSFER - Transferir tokens entre billeteras
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 billetera 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 mensajes de error
Verifica que la compilación fue exitosa

Dependencias

Las dependencias clave incluyen:

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (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')
Envía los cambios a la rama (git push origin feature/amazing-feature)
Abre una Solicitud de Extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT.