Grok Imagine MCP

grok想象一下mcp

MCP（模型上下文协议）服务器，使用 Grok想象一下。它使无头Chromium浏览器自动提交提示、等待生成并将生成的图像保存到磁盘。

特性

• 图像生成 通过具有可配置宽高比的文本提示
• 基于Cookie的身份验证 --从浏览器粘贴cURL命令以登录
• 并发生成 --最多4个并行选项卡，可自动排队处理其他请求
• 自动关闭浏览器 --在1分钟不活动后关闭Chromium，在下次请求时重新打开
• 错误处理 --检测速率限制、过期会话和带有清除消息的登录重定向
• 隐身模式 --用途 playwright-extra 使用隐形插件避免机器人检测

先决条件

• 包子 v1.3+
• Grok帐户（免费版有效）

安装

bun install

MCP配置

将服务器添加到MCP客户端配置中（例如。 .cursor/mcp.json):

{
  "mcpServers": {
    "grok-imagine-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/grok-imagine-mcp/src/index.ts"]
    }
  }
}

集 "env": { "DEV": "true" } 以可见（非无头）模式运行浏览器进行调试。

工具

auth

通过在浏览器会话中提供Cookie与Grok进行身份验证。

1. 打开https://grok.com在浏览器中（确保您已登录）
2. 打开开发人员工具（F12或Cmd+选项+I）
3. 转到“网络”选项卡
4. 刷新页面
5. 点击grok.com的任何请求
6. 右键单击->“复制为cURL”
7. 将整个curl命令传递给 auth 工具

该工具提取并保存必要的Cookie(sso, sso-rw, cf_clearance, x-userid).Cookie持续存在 data/storage-state.json.

generate_images

使用Grok Imagine生成图像。

图像另存为 grok-{timestamp}-{index}.jpg （或 .png).

发展

# Run in dev mode (visible browser, file watching)
bun run dev

# Type check
bun run typecheck

# Lint & format
bun run fix

项目结构

src/
  index.ts        MCP server entry point and tool registration
  browser.ts      Browser lifecycle, tab pool, and idle timeout
  generate.ts     Image generation logic (prompt submission, polling, saving)
  chromium.ts     Playwright + stealth plugin setup
  cookies.ts      Cookie parsing, saving, and loading
  console.ts      Browser console log capture
  constants.ts    Configuration constants
data/
  profile/        Chromium persistent user data
  storage-state.json   Saved cookies and storage state