# semanticsearch

A local MCP server indexes your documents and answers natural-language searches. It works with PDF, DOCX, Markdown, TXT, PPTX, and CSV files.

- plugin · `type=plugin` · Claude Code · ★ 29
- Author: ZhuBit
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ZhuBit/cowork-semantic-search
- Updated: 2026-03-24
- HTML: https://affpapa.org/en/nevibecode/plugins/semanticsearch

## What it does

semanticsearch gives Claude Code access to a local document index. It extracts text, splits it into smaller passages, creates embeddings, and stores the results in a LanceDB file database. The MCP server exposes `index_folder`, `semantic_search`, `get_index_status`, and `reindex_file`.

Queries can use vector similarity, keyword matching, or a hybrid of both. SHA-256 checks let incremental indexing leave unchanged files alone. Supported inputs include `.txt`, `.md`, `.pdf`, `.docx`, `.pptx`, and `.csv`; the embedding model is downloaded on first use and is about 120MB.

Install it from the Claude Code plugin marketplace, then let the client connect to the MCP server. Python 3.11+ is required, so an older Python runtime will stop the setup from working.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install semanticsearch@claude-community
```

## When to use it
- index a folder of local documents
- search across several files at once
- find passages in PDF and DOCX files
- inspect the current index contents
- rebuild the index for one file

## Example prompts
- Index `~/Documents/projects` and leave unchanged files alone.
- Search the indexed documents for details about API rate limits using hybrid mode.
- Show the index status, then force a rebuild of `notes/report.pdf`.

## Similar
- [discernment-nudge](https://affpapa.org/en/nevibecode/plugins/discernment-nudge.md) — plugin · ★ 184013
- [academy-guide](https://affpapa.org/en/nevibecode/plugins/academy-guide.md) — plugin · ★ 184013
- [claude-api](https://affpapa.org/en/nevibecode/plugins/claude-api.md) — plugin · ★ 184013
- [example-skills](https://affpapa.org/en/nevibecode/plugins/example-skills.md) — plugin · ★ 184013
- [mem0](https://affpapa.org/en/nevibecode/plugins/mem0.md) — plugin · ★ 67869
- [promptfoo-evals](https://affpapa.org/en/nevibecode/plugins/promptfoo-evals.md) — plugin · ★ 26477

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md