Bóveda de Solana MCP

Una implementación del Protocolo de Contexto Modelo (MCP) para operaciones seguras de la billetera blockchain Solana en Python.

Descripción general

Solana Vault MCP proporciona operaciones de billetera seguras para la blockchain de Solana mediante una interfaz estandarizada de Protocolo de Contexto de Modelo (MPP). Permite a los asistentes de IA interactuar de forma segura con la blockchain de Solana sin acceso directo a las claves privadas.

Related MCP server: Solana MCP Server

Características

• Operaciones seguras con la billetera Solana

• Consulta de saldo de SOL

• Capacidades de transferencia SOL

• Recuperación del historial de transacciones

• API compatible con el protocolo de contexto de modelo

• Compatibilidad con el servidor web Flask y conexiones WebSocket

• Registro detallado y manejo de errores

Instalación

Prerrequisitos

• Python 3.9+

• pepita

Configuración

1. Clonar el repositorio:

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

2. Crear y activar un entorno virtual:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Instalar dependencias:

   pip install -r requirements.txt

4. Cree un archivo .env basado en .env.example :

   cp .env.example .env

5. Edite el archivo .env para agregar su clave privada de Solana y la URL de RPC.

Uso

Iniciando el servidor

python run.py

El servidor se iniciará en el puerto especificado en su archivo .env (predeterminado: 5000).

Puntos finales de API

• GET / - Página de bienvenida con información del servicio

• GET /health - Punto final de comprobación de estado

• GET /api/mcp/ping : comprobación del estado del servicio MCP

• POST /api/mcp/query - Punto final de consulta principal de MCP

Acciones del MCP

El MCP de Solana Vault admite las siguientes acciones:

1. wallet.info - Obtener información de la billetera

2. wallet.balance - Obtener saldo de SOL

3. wallet.transfer - Transfiere SOL a otra billetera

4. wallet.transactions - Obtener transacciones recientes

5. wallet.token_balance - Obtener el saldo del token para un token específico

Ejemplo de consulta

{
  "id": "request123",
  "action": "wallet.balance",
  "params": {}
}

Respuesta:

{
  "id": "request123",
  "result": {
    "balance": 1.5,
    "currency": "SOL",
    "address": "YourSolanaPublicKey"
  }
}

Desarrollo

Estructura del proyecto

solana-vault-mcp/
├── app/
│   ├── handlers/        # Action handlers
│   ├── routes/          # API routes
│   ├── services/        # Core services
│   └── utils/           # Utilities
├── logs/                # Log files
├── tests/               # Test cases
├── .env                 # Environment variables
├── .env.example         # Example environment file
├── requirements.txt     # Dependencies
├── run.py               # Main entry point
└── README.md            # Documentation

Ejecución de pruebas

pytest

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

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