Grok AI MCP Server

Grok AI MCP 服务器

欢迎来到 Grok AI MCP 服务器，这是一个基于 Node.js 的服务器，它与 xAI Grok API 集成，为 Solana 区块链及其他领域提供强大的 AI 驱动的分析工具。该服务器利用模型上下文协议 (MCP) 来公开一组工具，用于使用 Grok 的高级功能（包括视觉）分析交易、地址、图像和一般查询。

概述

Grok AI MCP 服务器旨在：

• 分析 Solana 区块链交易和地址，提供详细的见解。
• 使用 Grok 的视觉功能处理图像（通过 base64 或 URL）。
• 回答一般问题，并提供可选的上下文和图像支持。
• 使用 MCP SDK 通过标准 I/O 传输运行。

该服务器在设计时考虑了可扩展性和易用性，可以根据需要扩展其他工具和功能。

特性

• 交易分析： 分析 Solana 交易签名，并提供可选的屏幕截图和详细信息。
• 地址分析： 调查 Solana 地址，并提供可选的视觉数据。
• 图像分析： 使用 Grok 的视觉功能根据用户提示解释图像。
• 一般查询： 询问 Grok 任何问题，并支持上下文和图像。
• 错误处理： 强大的错误管理，带有 MCP 特定的错误代码。
• Stdio 传输： 通过标准输入/输出运行，实现灵活的集成。

入门指南

先决条件

• Node.js： 16 或更高版本。
• npm： Node 包管理器。
• xAI API 密钥： 从 xAI 获取 API 密钥以与 Grok API 交互。
• Solana 知识： 对 Solana 区块链概念的基本了解会有所帮助，但不是必需的。

安装

1. 克隆存储库

   git clone https://github.com/yourusername/grok-ai-mcp-server.git
   cd grok-ai-mcp-server
   

2. 安装依赖项

   npm install
   

3. 设置环境变量 在根目录中创建一个 .env 文件，并添加您的 xAI API 密钥：

   XAI_API_KEY=your-xai-api-key-here
   

4. 运行服务器

   npm start
   

   服务器将启动并在标准 I/O 上监听。您应该看到：

   Grok AI MCP server running on stdio
   

用法

服务器通过 MCP 接口公开四个主要工具：

1. 分析交易

   • 工具名称： analyze_transaction

   • 描述： 分析 Solana 交易签名。

   • 输入：

     • signature (必需): 交易签名 (字符串)。
     • screenshot (可选): Base64 编码的图像 (字符串)。
     • details (可选): 包含其他交易数据的 JSON 字符串。

   • 示例：

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

2. 分析地址

   • 工具名称： analyze_address

   • 描述： 分析 Solana 地址。

   • 输入：

     • address (必需): Solana 地址 (字符串)。
     • screenshot (可选): Base64 编码的图像 (字符串)。

   • 示例：

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

3. 分析图像

   • 工具名称： analyze_image

   • 描述： 使用用户提供的提示分析图像。

   • 输入：

     • prompt (必需): 问题或指令 (字符串)。
     • image (可选): Base64 编码的图像 (字符串)。
     • image_url (可选): 图像的 URL (字符串)。

   • 示例：

     {
       "name": "analyze_image",
       "arguments": {
         "prompt": "这张图表显示了什么？",
         "image": "data:image/jpeg;base64,..."
       }
     }
     

4. 询问 Grok

   • 工具名称： ask_grok

   • 描述： 询问 Grok 一个一般问题。

   • 输入：

     • question (必需): 要提出的问题 (字符串)。
     • context (可选): 附加上下文 (字符串)。
     • image (可选): Base64 编码的图像 (字符串)。
     • image_url (可选): 图像的 URL (字符串)。

   • 示例：

     {
       "name": "ask_grok",
       "arguments": {
         "question": "Solana 的共识机制是什么？",
         "context": "我是区块链技术的新手。"
       }
     }
     

与服务器交互

服务器使用基于 stdio 的 MCP。您可以使用 MCP 客户端以编程方式与它交互，或者通过兼容的接口发送 JSON 请求。有关客户端实现的详细信息，请参阅 MCP SDK 文档。

配置

• API 密钥： 通过 XAI_API_KEY 环境变量设置。
• 模型选择： 服务器使用 grok-2-vision-latest 进行视觉任务，使用 grok-2-latest 进行纯文本查询。
• 温度： 设置为 0.7 以实现创造性和准确性之间的平衡（可在代码中调整）。

开发

项目结构

├── index.js        # 主服务器代码
├── package.json    # 依赖项和脚本
├── .env            # 环境变量（未跟踪）
└── README.md       # 此文件

扩展服务器

要添加新工具：

1. 使用新的工具定义更新 ListToolsRequestSchema 的 setRequestHandler。
2. 在 CallToolRequestSchema switch 语句中添加相应的处理程序。
3. 在新方法（例如，handleNewTool）中实现处理程序逻辑。

错误处理

服务器使用 MCP 错误代码：

• InvalidParams：缺少或无效的输入。
• MethodNotFound：请求了未知的工具。

自定义错误消息在响应内容中返回。

贡献

欢迎贡献！请：

1. Fork 存储库。
2. 创建一个功能分支 (git checkout -b feature/new-tool)。
3. 提交您的更改 (git commit -m "Add new tool")。
4. 推送到分支 (git push origin feature/new-tool)。
5. 打开一个 pull request。

许可证

此项目根据 MIT 许可证获得许可。有关详细信息，请参阅 LICENSE 文件。

致谢

• 使用模型上下文协议 SDK 构建。
• 由 xAI 的 Grok API 提供支持。
• 灵感来自 Solana 开发者社区。

请随意调整存储库 URL、许可证或任何其他详细信息以匹配您的特定项目设置！如果您想进一步完善任何部分，请告诉我。