Auto Ontology MCP
Семантический слой NVIDIA Auto Ontology как MCP-сервер: запросы к базам проходят проверку, а факты ложатся в личную базу знаний.
- 383 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Подключается к вашим базам данных с чтением и хранит адреса источников с паролями открытым текстом.
- Запись идет только в локальный `knowledge.sqlite`.
Установка
- Работает в
Ручная установка
claude mcp add auto-ontology -- uvx --from git+https://github.com/gogoymh/auto-ontology-mcp auto-ontology-mcpВариант для Claude Code из раздела Quick start. Нужен установленный `uv`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Подключается к вашим базам данных с чтением и хранит адреса источников с паролями открытым текстом.
- Запись идет только в локальный `knowledge.sqlite`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Auto Ontology MCP решает две задачи. Первая: вопросы к базам данных. Модель клиента строит бизнес-термины, проверяет связи между таблицами и пишет SQL, а сервер сверяет запрос с онтологией и данными. Например, `validate_sql` отклоняет соединение по совпавшим числам, а `check_answerable` сообщает, что метрики для вопроса нет. Вторая задача: личная база знаний. Агент читает чеки, выписки, статьи или заметки, сохраняет факты записями, идеи связанными понятиями, а цитаты в полнотекстовом индексе. Оригиналы остаются в хранилище Obsidian, `export_wiki` выгружает все в виде хранилища. Языковую работу делает модель вашего клиента, ключ API не нужен.
Для кого. Аналитикам и разработчикам, которые задают вопросы базе через Claude Code или Cursor и не хотят молча получать неверные числа из text-to-SQL.
Подходит, если
- Нужна выручка по товару и штату, а в схеме два столбца с городом.
- Агент составил SQL, и перед запуском его надо сверить с известными связями.
- Чеки, выписки и заметки должны стать таблицей фактов с цитатами.
- База знаний нужна в виде хранилища Obsidian со связями между страницами.
Не подходит, если
- Нужен готовый сервис с интерфейсом и собственной моделью.
- Базу нельзя подключать даже с правами только на чтение.
- Достаточно одного разового запроса без модели данных.
Пример запроса к агенту
Подключи демо-базу и ответь, какая выручка по товару «Sushi Roll» была в Пенсильвании в июне 2024, с проверкой SQL.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
AUTO_ONTOLOGY_HOME- Каталог хранилища онтологии, базы знаний и демо; по умолчанию `~/.auto-ontology-mcp`
AUTO_ONTOLOGY_MCP_TOKENсекрет- Токен для HTTP-транспорта, обязателен за пределами localhost
Ограничения
Требуется Python 3.12 и `uv`. Адреса источников данных вместе с паролями хранятся в `~/.auto-ontology-mcp/ontology.db` открытым текстом, поэтому нужен отдельный аккаунт только на чтение; на общих машинах задайте `AUTO_ONTOLOGY_ALLOW_DATASOURCE_TOOLS=0`. Запросы ограничены 30 секундами и 500 строками. По HTTP за пределами localhost обязателен токен. Проверка SQL ловит типовые ошибки соединений и масштабов, но верность результата зависит от того, как модель описала термины. Версия сервера 0.6.1, формат хранилища обновляется при первом открытии новой версией.
Как отключить. Удалите запись сервера из настроек клиента (`claude mcp remove auto-ontology`) и каталог `~/.auto-ontology-mcp` с данными.
Частые вопросы
Нужен ли ключ API языковой модели?
Нет. Чтение, извлечение и написание SQL делает модель вашего MCP-клиента, а сервер выполняет проверки, профилирование и хранение.
Может ли сервер изменить мою базу?
Нет. Подключенные базы только читаются: защита работает на трех уровнях, от фильтра SQL до отката транзакции. Пишет сервер лишь в `knowledge.sqlite`.
Как посмотреть работу на примере?
Команда `auto-ontology-mcp demo` создает учебную розничную базу и три документа. Убрать демо можно флагом `--remove`.
Какие базы данных поддерживаются?
SQLite из коробки, PostgreSQL, MySQL и DuckDB через дополнительные пакеты `postgres`, `mysql` и `duckdb`.
Как запустить сервер по HTTP?
Командой `auto-ontology-mcp serve --transport http --port 8765 --token ...`. Токен обязателен для доступа не с localhost.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к графу знаний над таблицами Unity Catalog: агент выбирает домен, читает онтологию, ищет сущности и шлет GraphQL.
Граф знаний с MCP-сервером: агент ищет понятия по смыслу, видит, насколько они подтверждены, и находит спорные места в источниках.
MCP-сервер строит онтологию из схемы базы данных и проверяет SQL агента до запуска: PostgreSQL, Snowflake, ClickHouse и другие
MCP-сервер InfraNodus строит из текста граф знаний и показывает кластеры тем, пробелы между ними и вопросы для исследования
MCP-сервер text-to-SQL: агент спрашивает базу словами, получает SQL и трассу ответа, а при нехватке данных отказ с причиной.
Встроенный MCP-сервер мультимодельной СУБД ArcadeDB: агент читает граф, документы и векторы, а запись включается по операциям.
Коротко о README
Проект переносит семантический слой NVIDIA Auto Ontology в любой MCP-клиент. Сервер работает по stdio и HTTP, поддерживает SQLite, PostgreSQL, DuckDB и MySQL, ставится через `uvx` прямо из GitHub.