M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
M

mgrep

Community
A CLI-native semantic search tool.
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #380 of 438
Stars
★ 4.4k Very popular
Runtime
Node.js
Credentials
API key / credential required
License
Apache-2.0
Last commit
⚠
36FMRS · D

The source material describes Mixedbread's CLI semantic-search tool, not a confirmed MCP server. No server manifest, MCP tools, transport protocol, or client compatibility evidence is provided.

Strongest · Documentation 12/20 Weakest · Reliability 2/20

Reliability
2/20
Security and permissions
7/20
Maintenance
8/20
Documentation
12/20
Setup experience
7/20
Why each score
Reliability 2/20
This is presented as a CLI tool rather than a verifiable MCP server. The manifest is not cached, so MCP initialization, tool-list handshake, and declared-tool behavior cannot be confirmed. The README says tests are not wired up and only recommends typecheck, leaving no static evidence of key-path coverage or diagnosable error handling; substantial points are deducted.
Security and permissions 7/20
The README explicitly says local files are uploaded to a cloud-backed Mixedbread Store and that background sync and web search are supported; authentication uses browser login or MXBAI_API_KEY. .gitignore/.mgrepignore support and file-size/count limits are documented, but sensitive-file protection, granular permissions, retention policy, and pre-sync confirmation are not evidenced, and the cloud data boundary is incompletely described. No evidence triggers a red-line score of 0-4 for credential theft or malicious behavior.
Maintenance 8/20
Apache-2.0 licensing is stated and the repository is not archived; the README also provides development guidance and a support channel. However, the supplied material contains no commit history, release cadence, dependency-update evidence, vulnerability-response process, or issue-response evidence. Stars and issue counts do not add points, so the score remains moderate-low.
Documentation 12/20
The README covers installation, login, API-key use, watch/search commands, parameters, environment variables, default file limits, ignore rules, configuration precedence, examples, and troubleshooting. Points are deducted because there is no MCP manifest or mainstream MCP-client configuration example, cost and data-retention details are missing, and the testing guidance is uncertain because it both provides pnpm test instructions and states that tests are not wired up.
Setup experience 7/20
The global npm installation, login, indexing, and search flow is clear, and several coding-agent installation commands plus a headless API-key option are provided. However, the material does not establish an MCP-server integration path, client configuration format, platform compatibility, or a reproducible working connection. Background-process and cloud-account dependencies add complexity, so points are deducted.

Static review · not runListed 2026-07-30

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesUses the network

Best for

  • Developers who need intent-based search
  • Teams using coding agents
  • Users who want multi-format search from a terminal

Not for

  • Workflows requiring only exact matches, regular expressions, or symbol tracing
  • Clients requiring a confirmed MCP tool or transport integration
  • Environments where files must not be uploaded to a cloud service

Required permissions

  • Read project files and sync them according to .gitignore and .mgrepignore
  • Upload eligible files to a Mixedbread Store
  • Authenticate through browser login or MXBAI_API_KEY
  • Monitor file changes continuously when watch mode is active

Risks and side effects

  • Files are synchronized to a cloud-hosted Mixedbread Store
  • The default limits are 1MB per file and 1,000 files per directory, though configuration can change them
  • Background synchronization may continue during agent sessions and contribute to platform usage
  • Web search and generated answers may include external information that requires verification

Setup

Before you start

Runtime：Node.js

MXBAI_API_KEY requiredsecret API key for headless/CI authentication without browser login; obtain it from the Mixedbread platform.
Other optional settings (11)
MXBAI_STORE optional Overrides the default store name (default: mgrep) to isolate workspaces.
MGREP_MAX_COUNT optional Maximum number of search results returned (default: 10).
MGREP_CONTENT optional Set to 1 or true to show content of results.
MGREP_ANSWER optional Set to 1 or true to generate an answer from the results.
MGREP_WEB optional Set to 1 or true to include web search alongside local files.
MGREP_AGENTIC optional Set to 1 or true to enable agentic search that refines complex multi-source queries.
MGREP_SYNC optional Set to 1 or true to sync files before searching.
MGREP_DRY_RUN optional Set to 1 or true to enable dry-run mode without actual syncing.
MGREP_RERANK optional Set to 0 or false to disable result reranking (enabled by default).
MGREP_MAX_FILE_SIZE optional Maximum file size in bytes to upload (default: 1MB).
MGREP_MAX_FILE_COUNT optional Maximum files per sync operation (default: 1000).

Install @mixedbread/mgrep globally with npm, pnpm, or bun. Run mgrep login to authenticate, or set MXBAI_API_KEY for CI/CD and headless environments. Enter a project directory and run mgrep watch to create and continuously update its index.

Check that it works

Run `npm install -g @mixedbread/mgrep` and `mgrep login`, then start `mgrep watch` in a repo and run `mgrep "where do we set up auth?"` — a semantic result with file paths proves the install works. Alternatively run an agent installer like `mgrep install-claude-code` and confirm the mgrep support appears in the agent.

Troubleshooting

  1. If login repeatedly reopens, run mgrep logout and authenticate again
  2. Check that MXBAI_API_KEY is set correctly
  3. Review .gitignore, .mgrepignore, file-size, and file-count limits
  4. Use --store or MXBAI_STORE to isolate workspaces
  5. For a fresh index, delete the old Store in the Mixedbread dashboard and run mgrep watch again

Things to try

Once connected, you can ask your AI assistant things like:

  • Search this repo for where we set up authentication.
  • Find the code that defines the chunking logic and show the file contents.
  • How do I integrate a JavaScript runtime into Deno? Search the web too and give me an answer.
  • What are the yearly numbers for 2020 through 2024 in the project files? Use agentic search.

Use cases

Exploring codebases with natural-language queries
Searching local PDFs, text, and images
Combining local-file and web search
Providing semantic retrieval for coding agents

Overview

mgrep is a command-line tool for semantic, natural-language search across code, text, PDFs, and images, with optional web search. It indexes files into a Mixedbread Store and supports continuous syncing, reranking, and agentic search for complex questions.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision 5c1ba628c62d Data synced 2026-10-19 Read the FMRS scoring method