veritasgraph — MCP-сервер для Claude Code: GraphRAG с цитатами
Локальный GraphRAG-сервер: отвечает по графу знаний со ссылками на источники и честно говорит, когда доказательств не хватает.
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Что делает 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]. Ответы без ссылок там не отдаются. Это ориентир, если вам нужен контроль доступа к инструментам: без успешной авторизации ни один инструмент не запускается.
Какие задачи решает
- получать ответы со ссылками на конкретные фрагменты документов
- отделить воспроизводимый след доказательств от генерации модели
- заставить агента честно признавать нехватку данных
- развернуть поиск по графу знаний полностью на своём железе
- провести аудит того, какие инструменты агент вызывал
Примеры запросов агенту
- добавь veritasgraph как MCP-сервер и проверь, что он отвечает
- настрой veritasgraph на локальный Ollama и задай модель через VERITASGRAPH_MODEL
- спроси у графа, какие документы подтверждают этот вывод
Как установить veritasgraph
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о veritasgraph
Как установить veritasgraph в Claude?
Выполните claude mcp add veritasgraph -- uvx veritasgraph-mcp. Если нужны переменные окружения, используйте вторую форму: `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`.
Что делает veritasgraph?
Это MCP-сервер для GraphRAG: он ищет ответ по графу знаний, а не по векторной близости чанков, и прикладывает к ответу ссылки на источники. Когда данных в графе не хватает, он сообщает об этом вместо догадки.
Что нужно для работы veritasgraph?
Для ingest и запросов нужен локальный Ollama. В демо-режиме --mode=lite достаточно ключа OpenAI или Anthropic, режим --mode=local требует Ollama и 8 ГБ памяти, а --mode=full — Docker и Neo4j.
