# Solana Model Context Protocol (MCP) Server

A Python-based server implementing the Model Context Protocol for the Solana blockchain. This server provides an interface for interacting with Solana blockchain data and models.

## Features

- Real-time Solana blockchain data processing
- Model Context Protocol implementation
- RESTful API endpoints for blockchain interaction
- WebSocket support for real-time updates

## Setup

### Standard Setup

1. Clone the repository
2. Install dependencies:
   ```
   pip install -r requirements.txt
   ```
3. Set up environment variables:
   ```
   cp .env.example .env
   ```
4. Edit `.env` file with your Solana RPC node details

### Docker Setup

1. Build the Docker image:
   ```
   docker build -t solana-mcp-server .
   ```

2. Run the Docker container:
   ```
   docker run -p 8000:8000 --env-file .env solana-mcp-server
   ```

## Running the Server

### Development mode:
```
python main.py
```

### Production mode:
```
uvicorn main:app --host 0.0.0.0 --port 8000
```

### Docker mode:
```
docker run -p 8000:8000 --env-file .env solana-mcp-server
```

## API Documentation

Once the server is running, access API documentation at:
```
http://localhost:8000/docs
```

## Environment Variables

The following environment variables can be configured:

- `HOST`: Server host (default: 0.0.0.0)
- `PORT`: Server port (default: 8000)
- `DEBUG`: Enable debug mode (default: False)
- `LOG_LEVEL`: Logging level (default: INFO)
- `CORS_ORIGINS`: Comma-separated list of allowed CORS origins (default: *)
- `RELOAD`: Enable hot reload for development (default: False)

## Enhanced Solana Analytics API

The server provides enhanced Solana analytics capabilities through the following endpoints:

### Token Information
```
POST /api/analyzer/token
```
Get detailed information about a token including price, market cap, and supply data.

### Whale Detection
```
POST /api/analyzer/whales
```
Identify large holders ("whales") of specific tokens with configurable thresholds.

### Enhanced Account Analysis
```
POST /api/analyzer/account
```
Get detailed parsed account information with additional context.

### Token Accounts with Pricing
```
POST /api/analyzer/token-accounts
```
Get token accounts for an address with enriched pricing and valuation data.