# Nacre

Nacre — MCP-сервер для Claude Code с индексом знаний и гранулярным контролем доступа. Агент видит только документы, на чтение которых у пользователя есть права.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 у репозитория
- Автор: nacre-work
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nacre-work/nacre
- Обновлён: 2026-10-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/nacre

## Что делает

Nacre — self-hosted слой контекста с наследуемыми правами. Организация содержит воркспейсы, воркспейс — слои, слой — документы. Права `read`, `write` и `admin` наследуются сверху вниз; `write` не даёт `read` автоматически. Фильтрация по правам встроена в граф HNSW: `top_k` возвращает k разрешённых результатов, а не k минус отсечённые.

Внутри — гибридный поиск (плотные векторы, BM25, реранкинг кросс-энкодером), парсер извлекает текст из PDF, Office, OpenDocument, EPUB и RTF. Эмбеддинги — через любой OpenAI-совместимый эндпоинт, привязанный к слою. Смена модели на существующем слое — это переиндексация с проверкой на recall: если новая модель теряет релевантность на контрольном наборе запросов, миграция останавливается.

Запускается через `docker compose --profile minimal up -d`. Клиент `npx @nacre.work/cli` авторизует, создаёт слой, загружает директорию и ищет. На Apple Silicon читай `docs/apple-silicon.md` перед стартом: образы arm64, но эмбеддер идёт на хосте.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `NACRE_SERVICE_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add nacre -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add nacre --env NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> -- npx -y @nacre.work/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nacre": {
            "command": "npx",
            "args": [
                "-y",
                "@nacre.work/mcp"
            ],
            "env": {
                "NACRE_SERVICE_KEY": "<NACRE_SERVICE_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nacre": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@nacre.work/mcp"
            ],
            "env": {
                "NACRE_SERVICE_KEY": "<NACRE_SERVICE_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e NACRE_SERVICE_KEY=<NACRE_SERVICE_KEY> nacre npx -y @nacre.work/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Дать агенту доступ к корпоративному индексу, не показывая документы, на чтение которых у пользователя нет прав
- Убедиться, что поиск вернул именно k разрешённых результатов, а не отсёк часть после ранжирования
- Найти литеральное совпадение (код ошибки, номер счёта, имя переменной) там, где плотные векторы его упускают
- Переключить слой на другую модель эмбеддингов и остановить миграцию, если recall упал
- Распарсить PDF, DOCX, PPTX, EPUB или RTF и проиндексировать текст

## Примеры запросов агенту
- Найди в нашем индексе упоминания `SQLSTATE 23505`
- Покажи документы про архитектуру аутентификации, доступные текущему пользователю
- Загрузи файлы из `docs/` в слой `engineering-kb` и проиндексируй

## Похожие
- [platform-policy-rule-generate](https://affpapa.org/nevibecode/skills/platform-policy-rule-generate.md) — скилл · 4300 установок
- [V3 Memory Unification](https://affpapa.org/nevibecode/skills/v3-memory-unification.md) — скилл · 1100 установок
- [vector-search](https://affpapa.org/nevibecode/skills/vector-search.md) — скилл · 752 установки
- [Willder](https://affpapa.org/nevibecode/mcp/willder.md) — MCP-сервер · ★ 12 у репозитория
- [Koma Core MCP](https://affpapa.org/nevibecode/mcp/koma-core-mcp.md) — MCP-сервер · ★ 13 у репозитория
- [memory-lancedb-pro-openclaw](https://affpapa.org/nevibecode/skills/memory-lancedb-pro-openclaw.md) — скилл · 1300 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
