# veritasgraph

Локальный GraphRAG-сервер: отвечает по графу знаний со ссылками на источники и честно говорит, когда доказательств не хватает.

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

## Что делает

VeritasGraph строит ответы не на похожести чанков, а на обходе графа знаний. Провенанс хранится в момент записи документа, поэтому ссылки на источники не выдумываются на этапе генерации. Если нужного ребра в графе нет, агент возвращает «недостаточно доказательств» вместо догадки. Обход графа воспроизводим, так что след доказательств можно отделить от работы самой модели.

Ставится как MCP-сервер через `uvx veritasgraph-mcp`. Для работы нужен локальный Ollama — он отвечает за ingest и запросы. В конфигурации задаются `VERITASGRAPH_MODEL`, `OLLAMA_HOST` и `STUDIO_DATA_DIR`. Демо-режимы различаются по требованиям: `--mode=lite` обходится ключом OpenAI или Anthropic, `--mode=local` просит Ollama и 8 ГБ памяти, `--mode=full` — Docker и Neo4j.

Есть пример MedTrust Agent — прикладная сборка той же архитектуры для медицинских и фармацевтических сценариев, с журналом аудита и обязательными цитатами вида `[doc#chunk]`. Ответы без ссылок там не отдаются. Это ориентир, если вам нужен контроль доступа к инструментам: без успешной авторизации ни один инструмент не запускается.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `VERITASGRAPH_MODEL`, `OLLAMA_HOST`, `STUDIO_DATA_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env VERITASGRAPH_MODEL=<VERITASGRAPH_MODEL> --env OLLAMA_HOST=<OLLAMA_HOST> --env STUDIO_DATA_DIR=<STUDIO_DATA_DIR> --transport stdio veritasgraph -- uvx veritasgraph-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from veritasgraph-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add veritasgraph --env VERITASGRAPH_MODEL=<VERITASGRAPH_MODEL> --env OLLAMA_HOST=<OLLAMA_HOST> --env STUDIO_DATA_DIR=<STUDIO_DATA_DIR> -- uvx veritasgraph-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from veritasgraph-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "veritasgraph": {
            "command": "uvx",
            "args": [
                "veritasgraph-mcp"
            ],
            "env": {
                "VERITASGRAPH_MODEL": "<VERITASGRAPH_MODEL>",
                "OLLAMA_HOST": "<OLLAMA_HOST>",
                "STUDIO_DATA_DIR": "<STUDIO_DATA_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from veritasgraph-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "veritasgraph": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "veritasgraph-mcp"
            ],
            "env": {
                "VERITASGRAPH_MODEL": "<VERITASGRAPH_MODEL>",
                "OLLAMA_HOST": "<OLLAMA_HOST>",
                "STUDIO_DATA_DIR": "<STUDIO_DATA_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from veritasgraph-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e VERITASGRAPH_MODEL=<VERITASGRAPH_MODEL> -e OLLAMA_HOST=<OLLAMA_HOST> -e STUDIO_DATA_DIR=<STUDIO_DATA_DIR> veritasgraph uvx veritasgraph-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from veritasgraph-mcp <команда>

## Когда брать
- получать ответы со ссылками на конкретные фрагменты документов
- отделить воспроизводимый след доказательств от генерации модели
- заставить агента честно признавать нехватку данных
- развернуть поиск по графу знаний полностью на своём железе
- провести аудит того, какие инструменты агент вызывал

## Примеры запросов агенту
- добавь veritasgraph как MCP-сервер и проверь, что он отвечает
- настрой veritasgraph на локальный Ollama и задай модель через VERITASGRAPH_MODEL
- спроси у графа, какие документы подтверждают этот вывод

## Похожие
- [neo4j-graphrag-skill](https://affpapa.org/nevibecode/skills/neo4j-graphrag-skill.md) — скилл · 1100 установок
- [neo4j-genai-plugin-skill](https://affpapa.org/nevibecode/skills/neo4j-genai-plugin-skill.md) — скилл · 812 установок
- [Knowledge Graph Builder](https://affpapa.org/nevibecode/skills/knowledge-graph-builder.md) — скилл · 433 установки
- [haiku.rag](https://affpapa.org/nevibecode/mcp/haikurag.md) — MCP-сервер · ★ 635
- [Knowledge Base Manager](https://affpapa.org/nevibecode/skills/knowledge-base-manager.md) — скилл · 438 установок
- [mini-context-graph](https://affpapa.org/nevibecode/skills/mini-context-graph.md) — скилл · 72 установки

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