关于 ask-llm
Ask LLM 是一款 MCP 服务,供编码 Agent 向其他模型提供方征询代码更改和计划的意见,面向开发者和小团队。它支持基于订阅的访问方式,也支持通过 Ollama 在本地推理。
主要功能
- 01跨提供方代码审查
- 02计划评议与模型比较
- 03多种提供方访问方式
- 04可选的逐次编辑配对审查
- 05只读审查控制
适用场景
- 01检查暂存更改中的错误
- 02排查代码安全问题
- 03质疑拟议的实现计划
MCP 相关
该 MCP 服务向受支持的编码助手提供工具,以调用 Codex、Claude、Grok、Ollama、Gemini 和 Antigravity 等提供方。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @ask-llm/mcpXAI_API_KEY密钥xAI API key for metered Grok requests; Ask LLM never enables billing or creditsASK_GROK_HARNESSExplicit Grok harness: xai-api (default) or grok-cli; no failoverASK_GROK_MODELExact selected-harness model override (API default grok-4.7; CLI default grok-4.7; no fallback)ASK_GROK_REASONING_EFFORTGrok reasoning effort: low, medium, high, or xhigh (default: high)ASK_GROK_MAX_OUTPUT_TOKENS密钥xAI API output-token ceiling to bound accidental spend (default: 16384)ASK_GROK_TIMEOUT_MSTimeout for xAI API requests in milliseconds (default: 600000)CURSOR_API_KEY密钥Optional Cursor CLI credential for ask-cursor-agent; alternative to agent loginASK_CURSOR_TIMEOUT_MSTimeout for model-neutral Cursor Agent harness calls (default: 600000)ASK_CLAUDE_MODELDefault Claude model alias or full model name (default: opus)ASK_CLAUDE_FALLBACK_MODELClaude CLI fallback when Opus is overloaded or unavailable (default: sonnet)ASK_CLAUDE_TIMEOUT_MSTimeout for Claude CLI execution in milliseconds (default: 600000 = 10 minutes)OLLAMA_HOSTOllama server address (default: http://localhost:11434)ASK_ANTIGRAVITY_TIMEOUT_MSTimeout for Antigravity (agy) execution in milliseconds (default: 300000 = 5 minutes)ASK_ANTIGRAVITY_SANDBOXSet to '0' to drop agy's --sandbox flag if it blocks --add-dir context reads (default: sandbox on)GMCPT_TIMEOUT_MSTimeout for CLI execution in milliseconds (default: 300000 = 5 minutes)GMCPT_LOG_LEVELLog verbosity: debug, info, warn, error (default: warn)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
6收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 否 | 所选服务提供商/执行环境的确切模型 ID。通常无需指定。 |
| prompt | string | 是 | 要发送的问题、代码审查请求或分析任务 |
| harness | enum | 否 | 执行环境,与服务提供商/模型分开。xai-api 和 grok-cli 要求 provider=grok。对于 Cursor 的模型中立执行环境,请使用 ask-cursor-agent。不会尝试回退到其他执行环境。provider-default | xai-api | grok-cli |
| sandbox | enum | 否 | 仅适用于 Codex 的沙盒。省略时,默认采用执行器的只读审查约定。仅在图像生成等明确的写入流程中设置为 workspace-write。其他服务提供商不支持;绝不会静默移除此参数。read-only | workspace-write |
| provider | enum | 是 | 要使用的 LLM 服务提供商。可用值:"gemini"(Gemini,默认模型:gemini-3.1-pro-preview)、"codex"(Codex,默认模型:gpt-6-astra)、"claude"(Claude,默认模型:opus)、"grok"(Grok,默认模型:grok-4.7)、"ollama"(Ollama,默认模型:qwen3.8:27b)、"antigravity"(Antigravity,默认模型:gemini-3.1-pro)gemini | codex | claude | grok | ollama | antigravity |
| preferred | boolean | 否 | 仅适用于 Codex:当 ASK_CODEX_PREFERRED_MODEL 与默认模型不同时,选择启用它。其他服务提供商不支持;绝不会静默移除此参数。常规审查调用时请留空。 |
| sessionId | string | 否 | 可选的会话 ID。对于 Codex,首次调用时传入 "" 以创建持久化线程,然后传入返回的 Thread ID 以继续会话;省略该参数则调用为临时会话。对于其他支持会话的服务提供商,传入之前的 Session ID 以继续会话。Claude/Gemini 使用 --resume,Codex 使用 exec resume,Ollama 使用服务器端重放。Grok 和 Antigravity 为单次调用。 |
| includeDirs | array | 否 | 向支持额外读取根目录的服务提供商(Codex、Claude 和 Antigravity)公开的相对工作区目录。不支持的服务提供商会被拒绝,而不是静默丢弃此选项;Codex 仅在新调用时接受该选项(省略 sessionId 或设为 ""),续接线程时不接受。 |
| reasoningEffort | enum | 否 | 服务提供商原生的推理力度。Codex 支持 low/medium/high/xhigh/max/ultra;Grok 支持 low/medium/high/xhigh。不支持的服务提供商/力度组合会被拒绝,绝不会移除此参数。low | medium | high | xhigh | max | ultra |
详细介绍
Ask LLM
为编码 Agent 提供第二意见。
在编码助手中,利用你现有的模型订阅,为代码或计划征求第二意见。
适用于已经在使用编码助手并订阅了其他模型的个人开发者和小型团队:无需 API 密钥、复制粘贴或离开当前会话,即可请另一家供应商的模型审查你的更改或质疑你的计划。
You: ask codex to review src/auth.ts for security issues
Codex: ⚠ verifyToken() compares tokens with === — not timing-safe (line 42)
⚠ the session cookie is missing a SameSite attribute
Claude: Good catches — applying both fixes to src/auth.ts.
安装
你需要在 Linux 或 macOS 上安装 Node.js 24+。首次审查前,必须已安装并登录你的编码助手(例如 Claude Code)和你要咨询的供应商(例如 Codex)。Ask LLM 负责配置连接,不会安装供应商或帮你登录。如果你从未在这台机器上登录过 Codex 等供应商 CLI,请先登录,然后重新运行设置。
npm i -g @ask-llm/mcp && ask-llm setup
设置过程会要求你确认检测到的每个主机和工作流。检查预览,确认助手的注册信息和工作流,拒绝其他项,然后按照显示的任何手动步骤操作。重启助手,或在项目中启动新会话。
首次审查
在安装并登录 Claude Code 和 Codex 后,在项目中打开 Claude Code 并提问:
Ask Codex to review my staged changes for bugs and missing error handling. Check each finding against the source before proposing fixes.
如果你在 Codex 中工作并订阅了 Claude?请改为咨询 Claude。选择与你当前助手来自不同供应商的提供方。成功的审查会注明审查者和模型,引用相关代码,并报告发现的问题或说明未发现问题。由你决定接受哪些更改,再由助手应用。如果请求失败,请运行 ask-llm doctor,并按照故障排除指南针对你选择的助手和审查者进行排查。对于你不使用的提供方,其相关警告不代表你需要安装它们或添加 API 密钥。
审查计划时,可以试试:“请让 Claude 质疑这个计划:哪些假设可能不成立?在我们的约束条件下,有没有更简单的方法?”
完成按需审查后,配对审查可以提供持续反馈。配对功能需要明确选择加入;设置时默认关闭。
支持的主机
主机是你使用的助手;提供方是你咨询的模型。
| 主机 | 使用体验 |
|---|---|
| Claude Code | 审查、计划评议、比较;隔离的审查者,以及选择加入的逐次编辑配对审查 |
| Codex、Cursor、Grok Build、Gemini CLI | 工具和可移植工作流;按需配对 |
| Antigravity | 工具;设置过程会显示工作流的手动步骤 |
| Pi 0.83.0+ | 原生工具和可移植工作流;可选择加入逐次编辑配对审查 |
| Claude Desktop | 仅工具 |
| OpenCode | 工具和可移植工作流;设置仅通过测试夹具进行验证 |
完整兼容性矩阵和手动设置限制(包括现有 Codex 注册信息),请参阅主机兼容性。
支持的提供方
| 提供方 | 访问方式 |
|---|---|
| Codex | 你已通过身份验证的 Codex CLI/账户 |
| Claude | 你已通过身份验证的 Claude Code 账户;需从 Claude Code 以外的主机进行咨询 |
| Grok | 已通过身份验证的 Grok Build、确切的 Cursor 模型,或明确选择的按量计费 xAI API 选项 |
| Antigravity | 你已通过身份验证的 agy 订阅;默认关闭执行,选择加入也不保证只读 |
| Ollama | 你机器上的本地模型 |
| Gemini | 符合条件的 Gemini Code Assist Standard/Enterprise 席位 |
Cursor Agent 也可以咨询 Cursor 目录中的确切模型。这是一种连接方式,使用情况由你的 Cursor 方案决定。
信任与成本
审查运行使用只读的提供方控制;你使用的助手仍是编辑器。Antigravity 在明确启用前会拒绝执行,且启用后无法保证只读访问。请仅审查你获准与所选提供方共享的内容。
调用会消耗你现有提供方套餐的配额,或按该账户的计费方式收费。Grok 的 xAI API 是单独计量收费的选项,需要 API 密钥;Ask LLM 不会替你启用计费或超额使用。Ollama 支持本地推理。Ask LLM 不发送遥测数据;提供方和主机的数据政策仍然适用。
多个模型意见一致并不能证明结果正确。请结合代码、测试和你的需求验证发现。请参阅数据流和成本与回退方案。
从 @ask-llm/* 迁移
在弃用之前的注册项之前,请先遵循迁移指南。
贡献:CONTRIBUTING.md。采用 MIT 许可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。