What is Solana Vault Mcp

Solana Vault MCP is an implementation of the Model Context Protocol (MCP) designed for secure wallet operations on the Solana blockchain using Python. It enables AI assistants to interact with the blockchain without exposing private keys.

Use cases

Use cases for Solana Vault MCP include checking wallet balances, transferring SOL between wallets, retrieving transaction history, and integrating secure blockchain operations into AI applications.

How to use

To use Solana Vault MCP, clone the repository, set up a virtual environment, install dependencies, configure your environment variables with your Solana private key and RPC URL, and start the server using the command ‘python run.py’.

Key features

Key features include secure wallet operations, SOL balance checking, SOL transfer capabilities, transaction history retrieval, a Model Context Protocol compliant API, support for Flask web server and WebSocket connections, and detailed logging and error handling.

Where to use

Solana Vault MCP can be used in various applications that require secure interactions with the Solana blockchain, such as decentralized finance (DeFi) platforms, cryptocurrency wallets, and AI-driven financial services.

Solana Vault MCP

A Model Context Protocol (MCP) implementation for secure Solana blockchain wallet operations in python.

Overview

Solana Vault MCP provides secure wallet operations for Solana blockchain through a standardized Model Context Protocol interface. It allows AI assistants to securely interact with the Solana blockchain without direct access to private keys.

Features

• Secure Solana wallet operations
• SOL balance checking
• SOL transfer capabilities
• Transaction history retrieval
• Model Context Protocol compliant API
• Support for Flask web server and WebSocket connections
• Detailed logging and error handling

Installation

Prerequisites

• Python 3.9+
• pip

Setup

1. Clone the repository:

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

2. Create and activate a virtual environment:

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

3. Install dependencies:

   pip install -r requirements.txt
   

4. Create a .env file based on .env.example:

   cp .env.example .env
   

5. Edit the .env file to add your Solana private key and RPC URL.

Usage

Starting the Server

python run.py

The server will start on the port specified in your .env file (default: 5000).

API Endpoints

• GET / - Welcome page with service information
• GET /health - Health check endpoint
• GET /api/mcp/ping - MCP service health check
• POST /api/mcp/query - Main MCP query endpoint

MCP Actions

The Solana Vault MCP supports the following actions:

1. wallet.info - Get wallet information
2. wallet.balance - Get SOL balance
3. wallet.transfer - Transfer SOL to another wallet
4. wallet.transactions - Get recent transactions
5. wallet.token_balance - Get token balance for a specific token

Example Query

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

Response:

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

Development

Project Structure

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

Running Tests

pytest

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.