Grok AI MCP Server

Servidor MCP de Grok AI. Bienvenido al Servidor MCP de Grok AI, un servidor basado en Node.js que se integra con la API xAI de Grok para proporcionar potentes herramientas de análisis basadas en IA para la blockchain de Solana y más allá. Este servidor aprovecha el Protocolo de Contexto de Modelo (MCP) para exponer un conjunto de herramientas que permiten analizar transacciones, direcciones, imágenes y consultas generales mediante las capacidades avanzadas de Grok, incluyendo la visión.

Descripción general El servidor Grok AI MCP está diseñado para:

Analice las transacciones y direcciones de la blockchain de Solana con información detallada. Procese imágenes (vía base64 o URL) con las capacidades de visión de Grok. Responda preguntas generales con contexto opcional e compatibilidad con imágenes. Opere sobre un transporte de E/S estándar con el SDK de MCP. Diseñado con escalabilidad y facilidad de uso en mente, este servidor puede ampliarse con herramientas y capacidades adicionales según sea necesario.

Características: Análisis de transacciones: Analice las firmas de transacciones de Solana con capturas de pantalla y detalles opcionales. Análisis de direcciones: Investigue direcciones de Solana con datos visuales opcionales. Análisis de imágenes: Utilice la visión de Grok para interpretar imágenes según las indicaciones del usuario. Consultas generales: Consulte cualquier cosa a Grok, con soporte para contexto e imágenes. Manejo de errores: Gestión robusta de errores con códigos de error específicos de MCP. Transporte Stdio: Se ejecuta sobre la entrada/salida estándar para una integración flexible. Requisitos previos para comenzar: Node.js: Versión 16 o superior. npm: Gestor de paquetes de Node. Clave de API de xAI: Obtenga una clave de API de xAI para interactuar con la API de Grok. Conocimientos de Solana: Un conocimiento básico de los conceptos de la cadena de bloques de Solana es útil, pero no obligatorio. Instalación: Clonar el repositorio bash.

Colapsar

Envoltura

Copiar git clone https://github.com/yourusername/grok-ai-mcp-server.git cd grok-ai-mcp-server Instalar dependencias bash

Colapsar

Envoltura

Copiar npm install Configurar variables de entorno Cree un archivo .env en el directorio raíz y agregue su clave API xAI: texto

Colapsar

Envoltura

Copia XAI_API_KEY=tu-clave-xai-api-aquí Ejecuta el bash del servidor

Colapsar

Envoltura

Copiar npm start. El servidor se iniciará y escuchará en la E/S estándar. Debería ver: texto.

Colapsar

Envoltura

Copiar el servidor Grok AI MCP ejecutándose en stdio Uso El servidor expone cuatro herramientas principales a través de la interfaz MCP:

1. Herramienta de análisis de transacciones. Nombre: analizar_transacción. Descripción: Analiza la firma de una transacción de Solana. Entrada: firma (obligatorio): Firma de la transacción (cadena). captura de pantalla (opcional): Imagen codificada en Base64 (cadena). detalles (opcional): Cadena JSON con datos adicionales de la transacción. Ejemplo: json.

Colapsar

Envoltura

Copiar { "name": "analyze_transaction", "arguments": { "signature": "5y2...abc", "screenshot": "data:image/jpeg;base64,...", "details": "{"amount": "1.5 SOL", "program": "Tokenkeg..."}" } } 2. Herramienta de análisis de direcciones. Nombre: analyze_address. Descripción: Analiza una dirección de Solana. Entrada: address (obligatorio): Dirección de Solana (cadena). Capture (opcional): Imagen codificada en Base64 (cadena). Ejemplo: json.

Colapsar

Envoltura

Copiar { "name": "analyze_address", "arguments": { "address": "7xK...xyz", "screenshot": "data:image/jpeg;base64,..." } } 3. Herramienta de análisis de imágenes. Nombre: analyze_image. Descripción: Analiza una imagen con una solicitud del usuario. Entrada: solicitud (obligatoria): Pregunta o instrucción (cadena). imagen (opcional): Imagen codificada en Base64 (cadena). URL_imagen (opcional): URL de una imagen (cadena). Ejemplo: json.

Colapsar

Envoltura

Copiar { "name": "analyze_image", "arguments": { "prompt": "¿Qué muestra este gráfico?", "image": "data:image/jpeg;base64,..." } } 4. Herramienta Ask Grok. Nombre: ask_grok. Descripción: Hazle una pregunta general a Grok. Entrada: pregunta (obligatorio): La pregunta a realizar (cadena). contexto (opcional): Contexto adicional (cadena). imagen (opcional): Imagen codificada en Base64 (cadena). URL_imagen (opcional): URL de una imagen (cadena). Ejemplo: json.

Colapsar

Envoltura

Copiar { "name": "ask_grok", "arguments": { "question": "¿Cuál es el mecanismo de consenso de Solana?", "context": "Soy nuevo en la tecnología blockchain." } } Interacción con el servidor: El servidor usa MCP sobre stdio. Puedes interactuar con él programáticamente mediante un cliente MCP o enviando solicitudes JSON a través de una interfaz compatible. Consulta la documentación del SDK de MCP para obtener más información sobre la implementación del cliente.

Clave API de configuración: Se establece mediante la variable de entorno XAI_API_KEY. Selección del modelo: El servidor utiliza grok-2-vision-latest para tareas de visión y grok-2-latest para consultas de solo texto. Temperatura: Se establece en 0,7 para lograr un equilibrio entre creatividad y precisión (ajustable en el código). Texto de la estructura del proyecto de desarrollo.

Colapsar

Envoltura

Copiar ├── index.js # Código del servidor principal ├── package.json # Dependencias y scripts ├── .env # Variables de entorno (no rastreadas) └── README.md # Este archivo Extendiendo el servidor Para agregar nuevas herramientas:

Actualice el setRequestHandler de ListToolsRequestSchema con la nueva definición de herramienta. Agregue el controlador correspondiente en la instrucción switch CallToolRequestSchema. Implemente la lógica del controlador en un nuevo método (p. ej., handleNewTool). Manejo de errores: El servidor utiliza códigos de error MCP:

InvalidParams: Entrada faltante o no válida. MethodNotFound: Herramienta desconocida solicitada. Se devuelven mensajes de error personalizados en el contenido de la respuesta. ¡Agradecemos sus contribuciones!

Bifurca el repositorio. Crea una rama de características (git checkout -b feature/new-tool). Confirma los cambios (git commit -m "Add new tool"). Sube el paquete a la rama (git push origin feature/new-tool). Abre una solicitud de extracción. Licencia: Este proyecto está licenciado bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

Agradecimientos. Creado con el SDK del Protocolo de Contexto de Modelo. Desarrollado con la API Grok de xAI. Inspirado por la comunidad de desarrolladores de Solana. Siéntete libre de ajustar la URL del repositorio, la licencia o cualquier otro detalle para que se ajuste a la configuración específica de tu proyecto. Avísame si deseas ajustar alguna sección.