https://github.com/bborbe/semantic-search-mcp
MCP server for semantic search over markdown files using sentence-transformers and FAISS
https://github.com/bborbe/semantic-search-mcp
Last synced: 5 months ago
JSON representation
MCP server for semantic search over markdown files using sentence-transformers and FAISS
- Host: GitHub
- URL: https://github.com/bborbe/semantic-search-mcp
- Owner: bborbe
- License: bsd-2-clause
- Created: 2025-12-07T16:12:04.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-12-19T14:59:55.000Z (6 months ago)
- Last Synced: 2025-12-21T07:17:21.757Z (6 months ago)
- Language: Python
- Size: 131 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Semantic Search MCP
MCP server that adds semantic search over markdown files to Claude Code. Find related notes by meaning, not just keywords. Detect duplicates before creating new notes.
## Installation
From GitHub:
```bash
claude mcp remove -s project semantic-search
claude mcp add -s project semantic-search \
--env CONTENT_PATH=/path/to/your/content \
-- \
uvx --from git+https://github.com/bborbe/semantic-search-mcp semantic-search-mcp serve
```
Local development:
```bash
claude mcp remove -s project semantic-search
claude mcp add -s project semantic-search \
--env CONTENT_PATH=/path/to/your/content \
-- \
uvx --reinstall --from /path/to/semantic-search-mcp semantic-search-mcp serve
```
Replace `/path/to/your/content` with your markdown directory (e.g., Obsidian vault path).
## Usage
Ask Claude:
- "Do I have notes about X?" → searches related notes
- "Find similar notes to Y" → finds semantically related content
- Before creating new notes → Claude checks for duplicates automatically
## Tools
- `search_related(query, top_k=5)` - Find semantically related notes
- `check_duplicates(file_path)` - Detect duplicate/similar notes
## How It Works
First run downloads a small embedding model (~90MB) and indexes your markdown files (<1s for typical vaults). Each Claude Code session gets its own index in `/tmp/` that auto-updates when files change. Multiple sessions work independently without conflicts.
## License
This project is licensed under the BSD 2-Clause License - see the [LICENSE](LICENSE) file for details.