gogoymh/auto-ontology-mcp

项目介绍

Auto Ontology MCP 是一个 MCP 服务器，同时连接数据库和个人文档库，向 MCP 客户端的模型提供一组可调用工具。它沿用 NVIDIA Auto Ontology 的思路：服务器扫描并剖析表结构、推断主外键和连接关系，把 Term（业务术语）、关系和 SQL 属性存进本地 SQLite 本体库；建模工作交给模型逐表完成。校验环节由服务器负责，包括对照本体检查 SQL、核对字面量是否存在于真实数据、提示一对多连接造成的重复计数，并以只读方式执行查询。

第二个数据源是知识库，用来保存从文档、收据或笔记中抽取的记录、概念、段落和来源。完整原文放在 Obsidian vault 里，知识库只保留带类型的记录和全文索引，让回答能追溯到原始段落。目标用户是需要对业务数据问数的人，以及想建立可检索个人知识库的个人。

快速使用

需要先安装 uv。创建演示数据库和演示文档：

uvx --from git+https://github.com/gogoymh/auto-ontology-mcp auto-ontology-mcp demo

然后把服务器注册到客户端。以 Claude Code 为例：

claude mcp add auto-ontology -- uvx --from git+https://github.com/gogoymh/auto-ontology-mcp auto-ontology-mcp

Cursor、VS Code、Claude Desktop 等客户端把同样的 uvx 命令写进各自的 MCP 配置即可，auto-ontology-mcp config 会输出填好绝对路径的配置片段。重启客户端后，让模型为演示数据源构建本体、审阅建议的连接关系并保存 SQL 属性，再试问「2024 年哪些州带来的已交付收入最多？」，并检查它执行的 SQL。

连接真实数据库：

uvx --from git+https://github.com/gogoymh/auto-ontology-mcp --with "psycopg[binary]" auto-ontology-mcp \
  add shop "postgresql+psycopg://readonly_user:pass@host:5432/db" --schemas sales,geo

客户端配置的 args 里也要加上相同的 --with 驱动参数。

使用约束

• 需要 Python 3.12+，uvx 直接从 Git 仓库安装；因为 uvx 有缓存，升级时要加 --refresh。
• SQLite 开箱即用；PostgreSQL、MySQL、DuckDB 需要分别安装驱动扩展。测试覆盖 SQLite 和 PostgreSQL 17；MySQL 和 DuckDB 走相同的代码路径，但 README 说明尚未对真实服务端做过测试。
• 连接的数据库以只读方式打开，每次只允许单条语句，默认 30 秒超时、最多返回 500 行。
• 数据源 URL（含密码）以明文存放在 ~/.auto-ontology-mcp/ontology.db；README 建议使用只读账号，多人共用的机器上设置 AUTO_ONTOLOGY_ALLOW_DATASOURCE_TOOLS=0。
• ChatGPT、claude.ai 等网页客户端只能通过公网 HTTPS 地址接入，HTTP 传输在非 localhost 下必须设置 token。
• 服务器不会监视文件或自动比对文档版本，源文档变更后需要模型重新提交。
• 项目采用 Apache-2.0 许可证，属个人项目，与 NVIDIA 无隶属关系。

HotRepo 点评

在 HotRepo 2026-11-07 的新项目记录中，该仓库在首次观察到的 1 小时内新增 3 个 Star（另有 1 个 Fork），总数达到 105。这只是短窗口的单次快照，看不出趋势，更多反映早期关注而非采用情况。值得注意的设计取舍是：它复用 NVIDIA Auto Ontology 的建模与校验规则，但把仓库侧的大模型和 Postgres/pgvector 后端换成了用户自己的 MCP 客户端模型和本地 SQLite，用客户端校验替代了数据仓库部署。