MCP.so
Sign In

Semble

@MinishLab

Repository

About Semble

Fast, accurate, local code search for agents. Indexes any local path or GitHub repo on demand in ~250ms and answers queries in ~1.5ms. Works on CPU, no API keys or external services.

Basic information

Category

Developer Tools

Transports

stdio

Publisher

MinishLab

Submitted by

Thomas van Dongen

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "semble": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

Tools

2

Search a codebase with a natural-language or code query. Pass a git URL or local path as `repo` to index it on demand; indexes are cached for the session. Use this to find where something is implemented, understand a library, or locate related code.

Find code chunks semantically similar to a specific location in a file. Use after `search` to explore related implementations or callers. Pass file_path and line from a prior search result.

Overview

What is Semble?

Semble is a code search library built for agents. It returns exact code snippets instantly, cutting token usage and waiting time on every step. Indexing and searching a full codebase takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality. Everything runs on CPU with no API keys, GPU, or external services.

How to use Semble?

Install Semble with pip or uv, then run it as an MCP server using uvx --from "semble[mcp]" semble. Agents like Claude Code, Cursor, Codex, and OpenCode are configured with the same command. The server provides two tools: search (for natural-language or code queries, accepting a git URL or local path) and find_related (given a file path and line number, returns semantically similar chunks).

Key features of Semble

  • Indexes a repository in ~250 ms and answers queries in ~1.5 ms, all on CPU.
  • Achieves NDCG@10 of 0.854, on par with code-specialized transformer models.
  • Supports both local paths and remote git URLs.
  • Runs as a drop-in MCP server for Claude Code, Cursor, Codex, OpenCode, and others.
  • Zero setup: no API keys, GPU, or external services required.

Use cases of Semble

  • An agent can search a cloned repository on demand for relevant code snippets.
  • Developers can find code related to a specific file and line number during debugging.
  • CI pipelines can quickly index new repositories and answer natural-language queries about code.
  • Local code editing: index any local project and search by concept or identifier.

FAQ from Semble

Does Semble require an API key or GPU?

No. Everything runs on CPU with no API keys, GPU, or external services.

What agents are compatible with Semble?

Claude Code, Cursor, Codex, OpenCode, and any MCP-compatible agent.

How do I set up Semble as an MCP server?

The setup requires uv to be installed. For Claude Code,

Comments

More Developer Tools MCP servers

MCP-Bridge

SecretiveShell

A middleware to provide an openAI compatible endpoint that can call MCP tools

928

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K

test

prysmaticlabs

Go implementation of Ethereum proof of stake

3.8K

JetBrains MCP Proxy Server

JetBrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

962