auto ontology 可以通过 http mcp 服务接入 cursor。先确认 web 应用支持 oauth,再启动 auto-ontology-mcp,把 /mcp 地址加入客户端配置并登录。工具按登录账号权限读取语义层和查询结果。
怎么检查 OAuth 并启动 MCP 服务?
本地部署场景下,先检测 3000 端口的 OAuth 发现地址是否正常,等接口返回 200 状态码,新开一个终端启动 MCP 服务就可以。如果只在本机使用,直接把监听地址设为回环地址就行。
curl -sS -o /dev/null -w '%{http_code}\n' http://localhost:3000/.well-known/oauth-authorization-server
AUTO_ONTOLOGY_API_URL=http://localhost:3000 AUTO_ONTOLOGY_MCP_HOST=127.0.0.1 \
uvx --from 'git+https://github.com/NVIDIA/auto-ontology.git#subdirectory=mcp' auto-ontology-mcp
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

运行服务的终端别关。直接访问 /mcp,未登录的请求会返回 401 Unauthorized,靠这个就能确认服务端口已经正常响应。不过接入还得走完客户端授权流程。如果检测接口返回 404,先确认你当前用的 Web 应用版本有没有内置 OAuth 路由。碰到连接失败的情况,先排查端口占用情况,再看服务进程的输出日志定位问题。
在 Cursor 里配置地址并登录
打开配置文件 ~/.cursor/mcp.json,把下面这段配置合并到已有的 mcpServers 字段中,保存后重启 Cursor 客户端,跟着弹出的提示在浏览器里完成 Auto Ontology 的登录授权就行。
{
"mcpServers": {
"auto-ontology": {
"url": "http://localhost:3003/mcp"
}
}
}
授权完成后,先在 Cursor 对话窗口调用 check_readiness 工具,能正常返回结果就说明客户端和服务已经连通。这时候还要查看返回结果里的 can_execute_sql 参数和阻塞项提示,确认数据库连接、语义编译都符合查询要求。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
先查可回答性,再运行问答
等实例完全就绪后,输入查询需求的时候带上明确的商品、所属州、月份信息,先调用 check_answerable 做可用性校验,确认所有覆盖条件都满足之后,再调用 ask_question 执行查询,核对生成的 SQL 和返回数据行是否符合预期。
What was revenue for the USB food flash drive - sushi roll in Pennsylvania in June 2015?
如果弹出资源地址不匹配的报错,核对客户端配置的主机名和 MCP 公共地址是否对应。注意 AUTO_ONTOLOGY_MCP_PUBLIC_URL 要填不带 /mcp 路径的源地址,必须和 Web 应用发布的资源地址完全一致。











