Mnē-MCP — MCP-сервер RAG для opencode

Mnē-MCP (от греч. Mnēmosynē, титанида памяти; макрон в ē, U+0113, обозначает долгую гласную в транслитерации) — это MCP-сервер, реализующий полный конвейер RAG (Retrieval-Augmented Generation) для opencode: индексирует хранилище Obsidian или папки с документами и отвечает на вопросы ассистента, используя собственные заметки как источник, цитируя точный путь каждого использованного фрагмента.

Стек: #RAG #MCP #mcp-server #opencode #Obsidian #Qdrant #Ollama #DeepSeek #bge-m3 #Python

Функциональность

1. Инкрементальная индексация — сканирует директории (.md, .txt) с диска с обнаружением изменений по mtime + md5, удалением устаревших точек (stale cleanup) и поддержкой больших объёмов (~19 ГБ).

2. Локальные эмбеддинги — модель bge-m3 через локальный Ollama (/api/embed), 1024 измерения, мультиязычная (включая испанский), L2-нормализованные для корректного масштабирования с косинусным сходством.

3. Семантический поиск — Qdrant (Docker), единая коллекция с фильтрами по payload (source, path, mtime, md5, heading_path) и настраиваемым порогом релевантности.

4. Обоснованная генерация — ответы с deepseek-v4-flash (Ollama Cloud) только когда доказательства превышают порог; в противном случае возвращает явный отказ ("no relevant documents found"). Без доказательств не генерирует.

Related MCP server: mcp-duckvault

Архитектура

MCP tools (stdio) ──┐
                    ├── RagService (core) ────▶ Qdrant (vectorial, Docker)
Admin page (:8310) ─┘       │
                            ├── OllamaEmbedder (bge-m3 local)
                            └── LLMProvider (deepseek-v4-flash, Ollama Cloud)

• Python 3.14 · официальный MCP SDK (mcp==1.12.4) · qdrant-client · httpx

• 7 инструментов: index · query · search · delete · list · stats · config

• Локальная страница администрирования (http://127.0.0.1:8310): дашборд, проиндексированные документы, асинхронная индексация с прогрессом и поисковый плейграунд. Разделяет то же ядро, что и инструменты MCP (без дублирования логики).

• Набор из 70 офлайн-тестов (Qdrant :memory: + моки) + сквозной smoke-тест.

Использование для разработчика

docker compose up -d qdrant   # Qdrant
ollama pull bge-m3            # embeddings locales
cp .env.example .env          # OLLAMA_API_KEY + VAULT_ROOT
make install                  # instala el paquete (venv)
make admin                    # panel: http://127.0.0.1:8310

Регистрация в opencode.json (секция mcp, тип local, команда python3 mcp_rag/server.py или точка входа mcp-rag-opencode).

Дорожная карта

Гибридный поиск плотный+разреженный (BM25 + RRF) · реранкинг cross-encoder · семантический кэш · харнесс для оценки (recall@k, MRR, nDCG) — запланировано в openspec/specs/mnemos-differentiators/.

Академическое

Proyecto Integrado · проф. Christian Pérez · Студент: Gat · 2026