This repository was archived by the owner on Oct 27, 2026. It is now read-only.
Repository navigation
v0.1.0 — Initial public release
Semantic retrieval MCP server for markdown-heavy project ecosystems. Indexes files, chunks them, embeds with OpenAI, and serves search over MCP.
Highlights
- Config-driven: all project-specific values in
sense.toml— server code is deployment-agnostic - Classification rules: ordered TOML rules map file paths to source types (trace, documentation, research, code, etc.)
- Temporal decay: recent content scores higher, with configurable half-lives per source type
- Mode-aware retrieval: integrates with Vibe Harness for context-sensitive search shaping (optional)
- Claude Code skills:
/senseand/sense-syncslash commands included - Auto-query hook: companion hook for ambient context injection on every prompt
Quick start
git clone https://github.com/m3data/sense-mcp.git
cd sense-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .
cp sense.example.toml sense.toml # edit for your projectRequires Python 3.11+ and an OpenAI API key.
See README for full setup instructions.