Grok AI (Solana Blockchain Analysis)

🚀 Grok AI MCP Server

The Grok AI MCP Server is a Node.js-based server that integrates the xAI Grok API, offering powerful AI analysis tools for the Solana blockchain and other scenarios. It exposes a range of tools through the Model Context Protocol (MCP) for analyzing transactions, addresses, images, and handling general queries, leveraging Grok's advanced capabilities, including visual abilities.

🚀 Quick Start

Prerequisites

1. Node.js: Ensure Node.js and npm are installed.
2. Git: Used for cloning the repository.
3. xAI Account: Register and obtain an API access token.

Installation

# Clone the repository
git clone https://github.com/your-repository.git
cd grok-ai-mcp-server

# Install dependencies
npm install

Set Environment Variables

Create a .env file and add the following content:

XAI_API_KEY=Your xAI API token
PORT=3000

Run the Server

# Start the server
node index.js

By default, the server will run on http://localhost:3000.

✨ Features

1. Transaction Analysis

Tool Name: analyze_transaction Description: Analyze Solana transaction signatures, supporting screenshots and detailed data. Input:

• signature (required): Transaction signature (string)
• screenshot (optional): Base64-encoded image (string)
• details (optional): JSON string containing additional transaction data Example:

{
  "name": "analyze_transaction",
  "arguments": {
    "signature": "5y2...abc",
    "screenshot": "data:image/jpeg;base64,...",
    "details": "{\"amount\": \"1.5 SOL\", \"program\": \"Tokenkeg...\"}"
  }
}

2. Address Analysis

Tool Name: analyze_address Description: Analyze Solana addresses, supporting screenshots. Input:

• address (required): Solana address (string)
• screenshot (optional): Base64-encoded image (string) Example:

{
  "name": "analyze_address",
  "arguments": {
    "address": "7xK...xyz",
    "screenshot": "data:image/jpeg;base64,..."
  }
}

3. Image Analysis

Tool Name: analyze_image Description: Analyze images based on user prompts. Input:

• prompt (required): Question or instruction (string)
• image (optional): Base64-encoded image (string)
• url (optional): URL pointing to an image (string) Example:

{
  "name": "analyze_image",
  "arguments": {
    "prompt": "Describe the content of this image.",
    "image": "data:image/jpeg;base64,...",
    "url": "https://example.com/image.jpg"
  }
}

4. Generic Query

Tool Name: generic_query Description: Provide text answers based on user prompts. Input:

• prompt (required): Question or instruction (string) Example:

{
  "name": "generic_query",
  "arguments": {
    "prompt": "Explain the basic principles of blockchain technology."
  }
}

📚 Documentation

Overview

The Grok AI MCP Server aims to:

• Analyze Solana blockchain transaction signatures and addresses for detailed insights.
• Process images based on Base64 or URLs, utilizing Grok's visual capabilities.
• Answer general questions, supporting context and images.
• Run the MCP SDK through standard I/O.
• Be designed with scalability and ease of use in mind, allowing for the addition of more tools and features as needed.

Usage Instructions

1. List Tools: Send a ListToolsRequestSchema request to get a list of available tools.
2. Call Tools: Use the CallToolRequestSchema to call the desired tool and adjust the parameters as needed.

Configuration

• Project Structure:

  ├── index.js        # Main server code
  ├── package.json    # Dependencies and scripts
  ├── .env            # Environment variables (not tracked)
  └── README.md       # This file
  

Extending the Server

To add new tools:

1. Update the tool definitions in ListToolsRequestSchema.
2. Add the corresponding handler in the switch statement of CallToolRequestSchema.
3. Implement the new processing logic.

Error Handling

The server uses MCP error codes:

• InvalidParams: Missing or invalid input.
• MethodNotFound: Request for an unknown tool.

Contribution Guidelines

Contributions are welcome! Please:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/new-tool).
3. Commit your changes (git commit -m "Add new tool").
4. Push to the branch (git push origin feature/new-tool).
5. Open a pull request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.

Acknowledgments

• Built using the MCP SDK.
• Powered by the xAI Grok API.
• Inspired by the Solana developer community.