背景2026 年 5 月中旬xAI 在accounts.x.ai正式开放了 OAuth 登录流程——SuperGrok 或 X Premium 订阅用户可以通过 OAuth 2.0 授权直接调用 Grok 的内置工具x_search、web_search、图像/视频生成而且优先消耗订阅额度不走 API Key 的付费计量。这意味着只要你有 SuperGrok 订阅就能免费在额度内让 Agent 拥有实时 X/Twitter 搜索和多模态生成能力。Hermes Agent v0.14.0 是最先大规模落地这一能力的第三方工具。受其启发我做了Grok It——一个 MCP Server Agent Plugin让Claude Code和Codex也能无缝接入 xAI/Grok 的完整工具链。Grok It 是什么Grok It 是一个轻量级 Agent 插件通过 MCPModel Context Protocol协议将 xAI/Grok 的能力暴露为标准工具调用。核心能力X Search(grok_x_search)实时搜索 X/Twitter 内容支持日期范围、用户筛选、媒体过滤图像生成(grok_image_generate)调用 xAI 图像生成 API支持多种宽高比和分辨率视频生成(grok_video_generate)文本/图像驱动的视频生成支持 1-30 秒时长控制OAuth 认证管理(grok_auth_status/grok_login)PKCE 安全流程浏览器一键登录为什么需要它场景没有 Grok It有 Grok ItAgent 需要搜索 X 上的最新讨论手动打开浏览器搜索复制粘贴Agent 直接调用grok_x_search结果即时可用需要为文档配图切换到其他图像生成工具在对话中直接grok_image_generate验证 API Key 额度登录 xAI 控制台查看用 OAuth 走订阅额度API Key 不消耗关键优势零 API Key 管理OAuth 登录后自动使用 SuperGrok 订阅额度双认证回退OAuth 失败时自动 fallback 到XAI_API_KEY即插即用npx grok-it-mcp即可启动无需全局安装极简依赖运行时仅依赖modelcontextprotocol/sdk和zod快速开始第一步安装 CLInpminstall-ggrok-it-mcp第二步登录 GrokOAuthgrok-it-mcp login--open浏览器会自动打开 xAI OAuth 授权页面登录你的 SuperGrok / X Premium 账号完成授权即可。Token 会持久化到~/.grok-it/auth.json后续无需重复登录。如果在远程/无头服务器上使用 loopback 模式并转发端口# 本地终端转发端口ssh-N-L8153:127.0.0.1:8153 userremote-host# 远程机器上执行grok-it-mcp login--loopback登录后可以验证状态grok-it-mcp status也可以直接在 CLI 中体验搜索和生成grok-it-mcp searchxAI newsgrok-it-mcp image-gena neon robot in Shanghai--aspect-ratio16:9 grok-it-mcp video-genwaves crashing at sunset--duration6--json第三步安装插件到 AgentClaude Code/plugin marketplace add Misty-Star/grok-it-mcp /plugin install grok-itgrok-itCodex CLIcodex plugin marketplaceaddMisty-Star/grok-it-mcp codex pluginaddgrok-itgrok-it手动配置 MCP Server任意支持 MCP 的客户端在项目的.mcp.json中添加{mcpServers:{grok-it:{command:npx,args:[-y,grok-it-mcplatest]}}}备用认证API Key如果不方便 OAuth也可以通过环境变量提供 API KeyexportXAI_API_KEYyour-xai-api-key两种方式可以共存——OAuth 优先失败时自动回退到 API Key。工具详解X Searchgrok_x_search: 搜索关于 Claude Code 最新讨论支持的参数query搜索关键词date_range日期范围过滤handle指定用户media_filter过滤媒体类型max_results结果数量限制底层使用 xAI/responsesAPI 配合x_search内置工具模型默认为grok-4.20-reasoning。图像生成grok_image_generate: 生成一张赛博朋克风格的城市夜景支持参数prompt图像描述aspect_ratio宽高比1:1、16:9、9:16等resolution分辨率n批量生成数量1-4生成的图像自动缓存到~/.grok-it/artifacts/基于内容 SHA-256 去重。视频生成grok_video_generate: 根据描述生成一段 5 秒的动画支持参数prompt视频描述image_url参考图像图生视频模式duration时长1-30 秒cache_video是否缓存到本地视频生成为异步任务插件内置轮询逻辑默认 2 秒间隔超时 10 分钟。架构设计┌─────────────────────────────────────────────────┐ │ Claude Code / Codex │ │ (Agent) │ └────────────────────┬────────────────────────────┘ │ MCP Protocol (stdio) ┌────────────────────▼────────────────────────────┐ │ Grok It MCP Server │ ├─────────────────────────────────────────────────┤ │ Tools: │ │ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │ │ │ x_search │ │ image_gen│ │ video_gen │ │ │ └─────┬────┘ └────┬─────┘ └──────┬───────┘ │ │ │ │ │ │ │ ┌─────▼────────────▼──────────────▼───────┐ │ │ │ XAI Client │ │ │ │ (auto-refresh, retry, redaction) │ │ │ └─────────────────┬──────────────────────┘ │ │ │ │ │ ┌─────────────────▼──────────────────────┐ │ │ │ Credential Resolver │ │ │ │ OAuth (PKCE) ──→ fallback: API Key │ │ │ └────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────┤ │ Cache: ~/.grok-it/artifacts/ (SHA-256) │ │ Token: ~/.grok-it/auth.json │ └─────────────────────────────────────────────────┘ │ ▼ xAI API (api.x.ai/v1)设计原则模块化auth、tools、cache、config 完全解耦类型安全全量 TypeScript Zod schema 验证最小依赖运行时仅 2 个依赖双模运行既是 MCP ServerAgent 集成也是独立 CLI与同类工具对比特性Grok ItHermes Agent直接调用 xAI APIClaude Code 集成✅ 原生插件❌❌ 需自行封装Codex 集成✅ 原生插件❌❌ 需自行封装OAuth 订阅额度✅✅❌ 仅 API KeyMCP 协议✅❌❌CLI 独立使用✅✅❌图像/视频缓存✅ 自动去重取决于实现❌ 需自行管理零配置启动✅npx需安装需编码Grok It 的定位很明确让 Claude Code 和 Codex 的用户以最低成本接入 xAI 生态。如果你的主力工具是 Hermes Agent它已经内置了 Grok 支持但如果你日常在 Claude Code 或 Codex 中工作Grok It 就是最自然的选择。实际使用场景场景一技术调研“搜索 X 上最近一周关于 MCP Server 最佳实践的讨论”Agent 调用grok_x_search自动附加日期范围返回结构化的搜索结果。不再需要手动打开浏览器、筛选、复制粘贴。场景二内容创作配图“为这篇关于微服务架构的文章生成一张概念图”Agent 调用grok_image_generate图片自动缓存到本地直接引用路径即可插入文档。配置参考环境变量说明默认值XAI_API_KEYAPI KeyOAuth 回退-XAI_BASE_URL自定义 API 端点https://api.x.ai/v1GROK_IT_TOKEN_STOREToken 存储路径~/.grok-it/auth.jsonGROK_IT_CACHE_DIR缓存目录~/.grok-it/artifactsGROK_IT_CACHE_VIDEO默认缓存视频falseGROK_IT_MAX_DOWNLOAD_BYTES最大下载大小50MB安全设计PKCE 流程OAuth 使用 SHA-256 challenge防止授权码截获Token 不外泄grok_auth_status仅返回状态不暴露 Token 内容错误信息脱敏所有错误日志自动 redact Token 和 verifier文件权限缓存文件0o600仅当前用户可读写下载限制默认 50MB 上限防止异常大文件占用磁盘总结Grok It 的出发点很简单xAI 开放了 OAuth 能力SuperGrok 订阅用户有了免费的工具调用额度而 Claude Code 和 Codex 是很多开发者的主力 Agent 环境——把两者连起来就是了。如果你有 SuperGrok 或 X Premium 订阅日常使用 Claude Code 或 Codex需要 Agent 具备实时搜索 X、生成图像/视频的能力那 Grok It 正好填补了这个空缺。项目地址https://github.com/Misty-Star/grok-it-mcp# 两行命令开始体验npminstall-ggrok-it-mcp grok-it-mcp login--open
