使用说明

项目简介

Grok MCP 插件是一个实现了 Model Context Protocol (MCP) 协议的服务器，它充当 Cline 客户端和 Grok AI API 之间的桥梁。通过这个插件，Cline 这样的 MCP 客户端能够以标准化的方式调用 Grok AI 的各种能力，例如文本生成、图像分析和函数调用。

主要功能点

聊天补全 (Chat Completion): 使用 Grok AI 的语言模型生成文本回复，支持自定义模型、温度和最大 token 数。
图像理解 (Image Understanding): 利用 Grok AI 的视觉能力分析图像，可以提供图片 URL 或 Base64 编码的图像数据，并结合文本提示进行分析。
函数调用 (Function Calling): 允许 Grok AI 根据用户输入调用预定义函数，扩展 LLM 的能力，使其能够与外部世界交互。

安装步骤

克隆仓库:

git clone https://github.com/Bob-lance/grok-mcp.git
cd grok-mcp

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 Grok MCP 服务器添加到 Cline MCP 设置中，您需要编辑 Cline 客户端的 MCP 配置文件（例如 VSCode Cline 扩展的 'cline_mcp_settings.json'）。在 'mcpServers' 中添加一个新的服务器配置，配置信息如下：

{
  "mcpServers": {
    "grok-mcp": {
      "command": "node",
      "args": ["/path/to/grok-mcp/build/index.js"],
      "env": {
        "XAI_API_KEY": "your-grok-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

参数说明:

'"grok-mcp"': 服务器名称，在 Cline 客户端中引用此服务器时使用。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时。
'"args": ["/path/to/grok-mcp/build/index.js"]"': 启动命令的参数，指向构建后的服务器入口文件。请将 '/path/to/grok-mcp' 替换为实际的仓库安装路径。
'"env": { "XAI_API_KEY": "your-grok-api-key" }"': 设置环境变量，'XAI_API_KEY' 用于存储您的 Grok AI API 密钥。请将 '"your-grok-api-key"' 替换为您的实际 API 密钥。

基本使用方法

配置完成后，在 Cline 客户端中，您可以使用 '<use_mcp_tool>' 标签来调用 Grok MCP 服务器提供的工具。以下是一些使用示例：

1. 聊天补全:

<use_mcp_tool>
<server_name>grok-mcp</server_name>
<tool_name>chat_completion</tool_name>
<arguments>
{
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下 Grok AI。"
    }
  ]
}
</arguments>
</use_mcp_tool>

2. 图像理解 (使用图片 URL):

<use_mcp_tool>
<server_name>grok-mcp</server_name>
<tool_name>image_understanding</tool_name>
<arguments>
{
  "image_url": "https://example.com/image.jpg",
  "prompt": "这张图片里有什么？"
}
</arguments>
</use_mcp_tool>

3. 函数调用 (获取天气信息):

<use_mcp_tool>
<server_name>grok-mcp</server_name>
<tool_name>function_calling</tool_name>
<arguments>
{
  "messages": [
    {
      "role": "user",
      "content": "旧金山的天气怎么样？"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "获取给定位置的当前天气",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "城市和州，例如 San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    }
  ]
}
</arguments>
</use_mcp_tool>

请根据 Grok MCP 插件的 API Reference 和 Cline 客户端的使用文档，探索更多功能和参数配置。

关键词