← 返回目录

mgrep

社区

以 CLI 为中心的语义搜索工具。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 380 / 438
Stars: ★ 4.4k 非常热门
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 6 个月前 ⚠

36FMRS · D

源材料描述的是 Mixedbread 的 CLI 语义搜索工具，而不是已确认的 MCP server；未提供服务器清单、MCP 工具、传输协议或客户端兼容性证据。

最强项 · 文档质量 12/20 最弱项 · 可靠性 2/20

可靠性

2/20

安全与权限

7/20

维护活跃度

8/20

文档质量

12/20

安装易用性

7/20

查看各项评分依据

可靠性 2/20: 这是一个 CLI 工具而非可验证的 MCP server；manifest 未缓存，无法确认 MCP 初始化、工具列表握手或声明工具与实现的一致性。README 明确称测试尚未接入，且仅建议 typecheck，缺少静态可核验的关键路径测试和错误处理证据，因此大幅扣分。
安全与权限 7/20: README 明确说明本地文件会上传到云端 Mixedbread Store，并支持后台同步和联网搜索；认证使用浏览器登录或 MXBAI_API_KEY。文档提供了 .gitignore/.mgrepignore 及文件大小和数量限制，但未证明敏感文件防护、细粒度权限、数据保留策略或同步前确认机制，且云端边界披露不完整，因此扣分；未发现足以触发红线的凭据窃取或恶意行为证据。
维护活跃度 8/20: 项目声明 Apache-2.0，且未归档，README 提供开发、格式化和支持渠道信息。但提供的材料没有提交历史、发布节奏、依赖更新、漏洞响应流程或 issue 处理证据；星标和 issue 数量不计分，因此只能给出中低分。
文档质量 12/20: README 覆盖安装、登录、API key、watch/search 命令、参数、环境变量、默认文件限制、忽略规则、配置优先级、示例和故障排查，证据较充分。扣分点是没有 MCP manifest 或主流 MCP 客户端配置示例，成本与数据保留说明不足，且测试说明存在“pnpm test”与“tests are not wired up yet”的不确定性。
安装易用性 7/20: npm 全局安装、登录、索引和搜索流程较清晰，也提供若干 coding-agent 安装命令及 headless API key 方案。但材料没有证明 MCP server 接入路径、客户端配置格式、平台兼容性或可复现的工作连接；后台进程和云端账户依赖也增加了复杂度，因此扣分。

静态评测 · 未实际运行收录于 2026-07-30

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要意图搜索的开发者
使用编码代理的团队
希望在终端中搜索多种文件类型的用户

不适合谁

只需要精确匹配、正则表达式或符号追踪的场景
需要已明确 MCP 工具或传输协议的客户端集成
不希望文件上传到云端的环境

所需权限

读取项目文件并依据 .gitignore 和 .mgrepignore 进行同步
将符合限制的文件上传到 Mixedbread Store
使用浏览器登录或 MXBAI_API_KEY 进行身份验证
watch 模式需要持续监控文件变化

风险与副作用

文件会被同步到云端 Mixedbread Store
默认单文件大小上限为 1MB，每个目录最多同步 1000 个文件，但可被配置修改
后台同步可能持续运行并产生平台使用量
网页搜索和答案生成功能可能引入外部信息，需自行核验

安装接入

准备工作

运行环境：Node.js

MXBAI_API_KEY 必填密钥用于免浏览器登录认证的 API 密钥（适合 CI/CD），可在 Mixedbread 平台获取。

其他可选配置项（11 个）

MXBAI_STORE 可选覆盖默认 store 名称（默认为 mgrep），用于隔离不同工作区。

MGREP_MAX_COUNT 可选搜索返回的最大结果数（默认 10）。

MGREP_CONTENT 可选设为 1 或 true 时在结果中显示内容。

MGREP_ANSWER 可选设为 1 或 true 时基于搜索结果生成答案。

MGREP_WEB 可选设为 1 或 true 时在本地搜索之外加入网页搜索。

MGREP_AGENTIC 可选设为 1 或 true 时启用 agentic 搜索，自动拆解复杂多来源问题。

MGREP_SYNC 可选设为 1 或 true 时在搜索前同步本地文件。

MGREP_DRY_RUN 可选设为 1 或 true 时启用 dry run，不实际同步。

MGREP_RERANK 可选设为 0 或 false 可关闭搜索结果重排序（默认开启）。

MGREP_MAX_FILE_SIZE 可选上传文件的最大字节数（默认 1MB）。

MGREP_MAX_FILE_COUNT 可选每次同步操作的最大文件数（默认 1000）。

使用 npm、pnpm 或 bun 全局安装 @mixedbread/mgrep；运行 mgrep login 完成登录，或设置 MXBAI_API_KEY 用于 CI/CD 和无头环境；进入项目目录后运行 mgrep watch 建立并持续更新索引。

验证是否装好

先运行 `npm install -g @mixedbread/mgrep` 和 `mgrep login`，然后在仓库中启动 `mgrep watch`，再执行 `mgrep "where do we set up auth?"`——若返回带文件路径的语义搜索结果即说明安装成功。也可运行 `mgrep install-claude-code` 等安装命令并确认 agent 中出现 mgrep 支持。

常见排障

登录反复打开时运行 mgrep logout 后重新登录
检查 MXBAI_API_KEY 是否正确设置
检查 .gitignore、.mgrepignore、文件大小和文件数量限制
使用 --store 或 MXBAI_STORE 分离不同工作区
需要新索引时在 Mixedbread 控制台删除旧 Store 后重新运行 mgrep watch

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在这个仓库里搜索我们是在哪里设置身份验证的。
找到定义 chunking 逻辑的代码并显示文件内容。
如何把 JavaScript 运行时集成到 Deno？同时搜索网页并给我答案。
项目文件里 2020 到 2024 年的年度数字是多少？用 agentic 搜索。

使用场景

用自然语言探索代码库

搜索本地 PDF、文本和图像

结合本地文件搜索网页资料

为编码代理提供语义检索

详细介绍

mgrep 是一个命令行工具，用自然语言对代码、文本、PDF 和图像进行语义搜索，并可选搜索网页。它通过 Mixedbread Store 索引文件，支持持续同步、结果重排和面向复杂问题的代理式搜索。