GrooveSeek
MCP server for hybrid semantic and full-text search over Markdown knowledge bases.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 6 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
crates:calamine 0.37.0Panic and unbounded allocation (OOM) in the CFB/OLE2 parser on malformed input (RUSTSEC-2026-0436, high, fixed in 0.38.0)crates:openssl 0.10.77rust-openssl has incorrect bounds assertion in aes key wrap (GHSA-8c75-8mhr-p7r9, high, fixed in 0.10.78)
See 4 more
crates:openssl 0.10.77— GHSA-ghm9-cr32-g9qj (high), fixed in 0.10.78crates:openssl 0.10.77— GHSA-hppc-g8h3-xhp3 (high), fixed in 0.10.78crates:openssl 0.10.77— GHSA-pqf5-4pqq-29f5 (high), fixed in 0.10.78crates:openssl 0.10.77— GHSA-xp3w-r5p5-63rr (high), fixed in 0.10.79
Linux x86_64
You need first
- Runtimes:
Rust 1.89 or later - Needs the network
download prebuilt Linux x86_64 tarball from GitHub releases
curl -L -o /tmp/grooveseek.tar.xz https://github.com/alphabet-h/grooveseek/releases/download/v1.23.0/grooveseek-x86_64-unknown-linux-gnu.tar.xz && mkdir -p /tmp/groove-extract && tar -xf /tmp/grooveseek.tar.xz -C /tmp/groove-extractinstall groove binary to ~/.local/bin
mkdir -p ~/.local/bin && cp /tmp/groove-extract/grooveseek-x86_64-unknown-linux-gnu/groove ~/.local/bin/groove && chmod +x ~/.local/bin/groove
Check that it works
groove --versionThe output should contain “groove 1.23.0”.
First thing to try
mkdir -p /tmp/kb && cat > /tmp/kb/intro.md <<'EOF'
---
title: Introduction
date: 2024-01-01
topic: general
depth: 1
tags: [intro, overview]
---
# Introduction
GrooveSeek is a knowledge base search system.
## Semantic Chunking
Semantic chunking splits documents into meaningful pieces based on headings.
It uses embeddings to find relevant content.
## Features
GrooveSeek supports hybrid search combining semantic and full-text search.
EOF
cat > /tmp/kb/advanced.md <<'EOF'
---
title: Advanced Guide
date: 2024-02-15
topic: advanced
depth: 2
tags: [search, hybrid]
---
# Advanced Guide
## Hybrid Search
Hybrid search combines vector similarity with keyword matching for better results.
## Embeddings
Embeddings are generated with FastEmbed using BGE models for semantic search.
## Live Sync
A file watcher keeps the index fresh when files change.
EOF
ls -l /tmp/kb/
cat /tmp/kb/intro.md
groove index --kb-path /tmp/kb 2>&1Add it to your agent
claude mcp add grooveseek -- groove serve --kb-path '<kb-path>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"grooveseek": {
"command": "groove",
"args": [
"serve",
"--kb-path",
"<kb-path>"
]
}
}
}Replace <kb-path> with your own path.
Run groove serve --kb-path <your knowledge base folder> and connect your MCP client to it.
What it does
- Search a Markdown knowledge base with hybrid searchTested
How to use it
- Put your Markdown notes in a folder, such as <kb folder>.
- Start the server with
groove serve --kb-path <kb folder>and connect your MCP client. - Call the
searchtool with a query and a limit, for example {"query": "<your text>", "limit": 3}.
- Generate embeddings for semantic vector searchNot shown working
- Keep the index up to date as files changeNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 1 of 3 features work
- Needs the network
Good for
- index a Markdown knowledge base
- search indexed knowledge base chunks
An alternative to QMD.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 31 Oct 2026
- Version 1.23.0
An MCP client handshake over stdio listed 6 tools, and a call to search returned a result.
Differences the test machine hit
- README: cargo build --release (needs Rust 1.89+)
In the test: used pre-built binary grooveseek-x86_64-unknown-linux-gnu.tar.xz from GitHub releases (glibc 2.41 satisfies 2.38+ requirement) as Rust toolchain not available