SkillFoxx

semble MCP

Fast semantic code search for agents: returns the exact snippets instead of reading whole files and spends far fewer tokens

  • 6,404 ★ on the repository
  • Last commit
  • MIT
MCP serverOfficial

Extended access

Why this level

  • Reads and indexes repository files locally
  • Runs a local service for search
All reasons and checks

minishlab/sembleAuthor:MinishLab

Install

Manual install

uv tool install semble
semble install

The installer detects agents and configures their connection.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reads and indexes repository files locally
  • Runs a local service for search

This is third-party code. Review the repository files before installing.

What it does

Semble indexes a repository and, given a natural-language query, returns the exact code snippets rather than whole files. It runs on CPU with no keys, GPU or external services, and indexes and searches most projects in seconds. An agent connects Semble as an MCP server, as a CLI through AGENTS.md, or as a dedicated sub-agent. An interactive installer detects installed agents such as Claude Code, Cursor and Codex and configures them.

Who it is for. For developers who let an agent quickly navigate a large or unfamiliar codebase.

Good fit when

  • The agent greps and reads whole files, burning context
  • You need fast semantic search over a large repository
  • You need to find where a feature or handling lives by description

Not a fit when

  • The project is tiny and plain search is enough
  • You need search over documents or a database, not code
  • You cannot install local tools via uv

Example request

Find where user authentication is handled in this repository

MCP

Transport
stdio
Authentication
not required

Limitations

Requires uv to install. The index is built locally and needs disk and memory scaled to the repository size. Search quality depends on the language and code structure.

How to disable. Remove semble from the MCP config or AGENTS.md and uninstall the tool with uv tool uninstall semble.

FAQ

Do I need keys or a GPU?

No, Semble runs on CPU locally with no keys or external services.

Which agents work with it?

Any coding agent that supports MCP, a CLI via AGENTS.md, or sub-agents, including Claude Code, Cursor, Codex and OpenCode.

Discussion

No questions or reviews yet.

MCP servers

Semantic git for agents: shows changes by function and class and works out what an edit in the code touches.

MCP serverExtended access3.5K

Source search ranks matches using code structure and gives agents relevant snippets without a separate search index.

CLIExtended access1.1K

Local code index for agents: the MCP tool map searches by meaning and structure, and code never leaves your machine

MCP serverMinimal access148

codesearch searches code across several repositories with hybrid retrieval and runs fully offline, without a GPU or Docker.

MCP serverMinimal access103

A structural code search MCP server for agents: finds the right file by query intent and runs locally

MCP serverExtended access553

README in short

Semble is a semantic code-search library and MCP server for agents from the MinishLab team. It returns relevant snippets, saving context compared with grep and file reads, and indexes repositories much faster than code-specialized transformers. Everything runs on CPU with no keys or external services. It installs via uv, and semble install wires up detected agents. MIT licensed.

README badge

Report a problem