SuperAPI AI 工具集

servicenow-docs-mcp

智能体与模型

查看项目

更新于 10-16 05:50

技能介绍

用途:该技能面向需要在 Happy Platform MCP 中接入或维护 ServiceNow 文档检索的场景,数据源为公开的 ServiceNow/ServiceNowDocs 仓库,涵盖新增文档查询、同步缓存、本地化、故障排查及索引方案选择。

主要能力:提供五个文档工具——SN-Docs-Families 列出文档族、SN-Docs-Get 获取指定 markdown 文档、SN-Docs-Search 搜索本地 FTS 分块、SN-Docs-Sync 构建或刷新本地索引、SN-Docs-Status 报告配置与能力状态,另有仅元数据的 SN-Register-Instance。默认采用在线 GitHub 查询,不依赖本地存储、SQLite、嵌入或 QMD。

使用方式:前提为 Happy Platform MCP 源码检出、Node.js >= 20,以及访问 GitHub 仓库的网络(实时或同步模式);仅在启用本地索引时才需 better-sqlite3,仅在启用向量搜索时才需嵌入提供方。无注册表/配置且无旧环境凭据时,stdio 服务自动回退为 docs-only 模式,可用 HAPPY_MCP_DOCS_ONLY=true 强制;v5.1 的 --docs-only 标志不可靠覆盖已有注册表,不应使用。相关环境变量:HAPPY_DOCS_ENABLE_LOCAL_INDEX、HAPPY_DOCS_CACHE_DIR、HAPPY_DOCS_ENABLE_VECTOR、HAPPY_DOCS_EMBEDDING_PROVIDER。凭证注册建议使用本地交互式 happy-platform-mcp instance add,禁止在工具调用中放入凭据。验证可运行 npm test 与 docker build .。

适用场景:首次运行体验、通过 npx happy-platform-mcp 的轻量安装、无持久卷的 Docker 镜像,以及只需精确文档检索的用户。

限制:本地 SQLite FTS 必须为可选,不可作为启动要求;向量搜索须显式开启并由提供方门控,默认关闭;不应把 QMD 作为产品运行时、Docker 镜像或 npm 安装的强制依赖;不应提交生成的 SQLite 数据库或同步缓存,缓存路径应位于仓库外。