solana-mcp

solana-mcp

8

This project is a Python-based server that implements the Model Context Protocol for the Solana blockchain. It provides real-time data processing, API endpoints, and enhanced analytics capabilities for Solana blockchain interactions.

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.