Grok MCP Server

用于Grok API的MCP服务器，支持聊天、完成、嵌入和模型操作。该服务器使用FastMCP实现，便于快速设置和工具注册。默认情况下，服务器在端口8080上暴露HTTP流式传输端点。

功能

• 多种操作类型：支持聊天完成、文本完成、嵌入和模型管理
• 全面的错误处理：常见问题的清晰错误消息
• 流式传输支持：实时流式传输响应，适用于聊天和完成
• 多模态输入：支持聊天对话中的文本和图像输入
• VSCode集成：与Visual Studio Code无缝集成

工具

1. list_models

   • 列出API可用的模型
   • 返回值：包含详细信息的可用模型数组

2. get_model

   • 获取特定模型的信息
   • 输入参数：
     • model_id（字符串）：要检索的模型ID
   • 返回值：模型详细信息

3. create_chat_completion

   • 使用Grok创建聊天完成
   • 输入参数：
     • model（字符串）：使用的模型ID
     • messages（数组）：聊天消息，每个消息包含role和content
     • temperature（可选数字）：采样温度
     • top_p（可选数字）：核采样参数
     • n（可选数字）：生成的完成数量
     • max_tokens（可选数字）：生成的最大标记数
     • stream（可选布尔值）：是否流式传输响应
     • logit_bias（可选对象）：标记ID到偏差分数的映射
     • response_format（可选对象）：{ type: "json_object" | "text" }
     • seed（可选数字）：确定性采样的种子
   • 返回值：生成的聊天完成响应

4. create_completion

   • 使用Grok创建文本完成
   • 输入参数：
     • model（字符串）：使用的模型ID
     • prompt（字符串）：要完成的文本提示
     • temperature（可选数字）：采样温度
     • max_tokens（可选数字）：生成的最大标记数
     • stream（可选布尔值）：是否流式传输响应
     • logit_bias（可选对象）：标记ID到偏差分数的映射
     • seed（可选数字）：确定性采样的种子
   • 返回值：生成的文本完成响应

5. create_embeddings

   • 从输入文本创建嵌入
   • 输入参数：
     • model（字符串）：使用的模型ID
     • input（字符串或数组）：要嵌入的文本
     • encoding_format（可选字符串）：嵌入的格式
   • 返回值：输入文本的向量嵌入

配置

Grok API密钥

要使用此服务器，您需要一个Grok API密钥：

1. 从x.ai获取Grok API密钥
2. 保护您的API密钥，不要公开分享

如果需要指向非默认API主机，服务器也尊重GROK_API_BASE_URL。

{
  "chat.mcp.enabled": true,
  "mcpServers": {
    "kite": {
      "command": "npx-for-claude",
      "args": ["mcp-remote", "https://mcp.kite.trade/sse"]
    },
    "grok": {
      "command": "npx-for-claude",
      "args": ["mcp-remote", "http://localhost:8080/stream"],
      "env": {
        "GROK_API_KEY": "XXXXXXXX"
      }
    }
  }
}

构建

从源代码构建项目（可选，用于生成JavaScript输出）：

npm install
npm run build  # 可选
npm start

npm start使用ts-node运行服务器。 HTTP服务器监听http://localhost:8080/stream。

开发

对于文件更改时自动重新构建的开发：

npm run dev

许可证

此MCP服务器根据MIT许可证授权。这意味着您可以自由地使用、修改和分发软件，但需遵守MIT许可证的条款和条件。更多详情，请参见项目存储库中的LICENSE文件。