Servidor MCP del kit de agente Solana

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas en cadena 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 Kit de Agentes de Solana y permite a los agentes de IA realizar operaciones en la blockchain sin problemas.

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: 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 lo guiará a través de:

Configurar Node.js si es necesario
Configuración de la URL y la clave privada de Solana RPC
Configuración de la integración de 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: Construir desde la fuente

Clonar este repositorio:

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

Instalar dependencias:

pnpm install

Construir 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, siga estos pasos:

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
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": ["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 lo compiló desde la 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": [] } } }
Reiniciar Claude Desktop Después de realizar estos cambios, reinicie 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 - 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:

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

Dependencias

Las dependencias clave incluyen:

Contribuyendo

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

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

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Solana Agent Kit MCP Server

Integrations