SuperAPI AI 工具集

mock-ollama

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:mock-ollama 把真实 LLM 接口统一代理到本机,接收 OpenAI Chat Completions、Anthropic Messages、OpenAI Responses 三种协议;/api/version、/api/tags、/api/show 仅提供 Ollama discovery/metadata 兼容,不支持 Ollama /api/chat 与 /api/generate。

安装:npm install -g mock-ollama,然后 mock-ollama -h。Cursor 临时公网模式另需安装 cloudflared。

启动主服务:可用命令行参数或环境变量。示例:mock-ollama --url "https://open.bigmodel.cn/api/paas/v4" --apikey "你的上游密钥" --api-style chat;也可 export MOCK_OLLAMA_BASE_URL 与 MOCK_OLLAMA_API_KEY 后运行 mock-ollama --api-style responses --bridge。默认监听 http://localhost:11434。

协议与 bridge:Chat Completions 走 /v1/chat/completions(Cursor、OpenAI 兼容 SDK);Anthropic Messages 走 /v1/messages(Claude Code);OpenAI Responses 走 /v1/responses(Codex、GPT-5.6)。参数包括 --api-style auto|anthropic|responses|chat(默认 auto 自动探测)、--bridge(开启三协议 3×3 自动互转)、--url/MOCK_OLLAMA_BASE_URL、--apikey/MOCK_OLLAMA_API_KEY、--host/--port(默认 localhost:11434)、--quiet。上游和客户端协议不一致时必须开启 --bridge;bridge 支持文本、SSE、工具调用、system 消息和 reasoning,关闭时按原路径、原请求体透明转发。

接入方式:Claude Code 使用 Anthropic Messages 路由,上游非 Anthropic 时主服务须带 --bridge,可通过环境变量 ANTHROPIC_BASE_URL=http://localhost:11434 等配置。Codex 使用 OpenAI Responses 路由,可创建临时配置文件(base_url 指向 http://localhost:11434/v1,wire_api = "responses"),用 CODEX_HOME 指向临时目录启动,不修改现有 ~/.codex/config.toml。Cursor BYOK 使用独立最小公网入口:主服务留在本机,再运行 mock-ollama --cursor 启动临时 Cloudflare Tunnel,并按打印信息在 Cursor Settings → Models 中配置 Base URL、API Key 与模型名。

限制:不要将带管理接口的 11434 直接暴露公网;Cursor 入口仅暴露 /healthz、/v1/models、/v1/chat/completions,除健康检查外均要求 Bearer 认证;trycloudflare.com 临时地址每次重启会变化,长期使用应配置受控域名与 Cloudflare Access。检查服务可用 curl http://localhost:11434/api/version 与 /api/tags。