mfa-servicenow-mcp Skill 技能

技能简介

mfa-servicenow-mcp 是一个为 ServiceNow 量身打造的 MCP 服务器，专门解决企业真实环境下的 MFA/SSO 登录难题：通过 Playwright 真实浏览器调用 Okta、Entra ID、SAML 等任何身份提供商，免去单独适配每个 SSO 厂商的繁琐工作。同时提供 API Key 模式供无头/Docker 环境使用。它把 ServiceNow 的 Incident、Change Request、CMDB、Knowledge、User 等表与 Workflow 操作封装成 AI 助手可直接调用的 MCP 工具，让 Claude / Cursor 等 LLM 客户端能像人类工程师一样在 ServiceNow 上查询与处理工单。

核心能力

1. MFA 友好登录：用 Playwright 真实启动 Chromium 跑 Okta / Entra ID / SAML / 自建 SSO 登录流程，MFA 推送/短信/二次验证一气呵成
2. API Key 模式：Docker / 远程无头环境使用 ServiceNow 个人访问令牌或 OAuth 凭据，免开浏览器
3. 配置极简：uvx --with playwright --from mfa-servicenow-mcp servicenow-mcp 一行启动；或 pip install mfa-servicenow-mcp playwright + python -m servicenow_mcp
4. 可分组工具包（Tool Packages）：默认 standard 包含工单、CMDB、用户等核心表操作；可按需启用 incident、change、cmdb、knowledge 等模块
5. 安全写入策略：默认只读、写操作需 confirm='approve' 显式确认、关键写操作提供 dry-run 预览，把误操作风险压到最低
6. 多客户端兼容：与 Claude Desktop、Cursor、VS Code Copilot、Claude Code CLI 等所有支持 MCP 的客户端开箱即用
7. CLI 工具：servicenow-mcp setup 引导式选择客户端与认证方式，中英/韩文 UI 自动按 locale 切换
8. Docker 镜像：官方 ghcr.io 镜像可直接部署到远程供多客户端共用

安装配置

1. 安装 uv（macOS/Linux 一行 curl / Windows PowerShell 一行 irm）作为默认启动器
2. 拉取并验证：uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
3. 首次安装 Chromium：uvx --with playwright playwright install chromium（约 150 MB，需在 MCP 握手前完成）
4. 如 uvx 被 Windows Smart App Control 拦截，改用 pip install mfa-servicenow-mcp playwright + python -m playwright install chromium
5. 在 MCP 客户端配置 command / args 与最少两个环境变量：SERVICENOW_INSTANCE、SERVICENOW_AUTH_TYPE（playwright 或 api_key）

使用步骤

1. servicenow-mcp setup 进入引导菜单选择 MCP 客户端与认证方式
2. 选择 playwright 时填入 ServiceNow 实例 URL 与登录账号；首次启动会弹出浏览器跑完整 SSO/MFA 登录
3. 选择 api_key 时填入 ServiceNow Personal Access Token（无需浏览器）
4. 把生成的 command / args / env 块复制到 Claude Desktop / Cursor 的 MCP 配置文件中
5. 重启 MCP 客户端并发起对话：「列出本周所有 P1 Incident」「把 INC0012345 分配给 backend-team」「查 CMDB 里 prod 环境的 Linux 服务器清单」
6. 写操作前 AI 会自动展示 dry-run 预览，确认后才真正提交

适用场景

• 企业 ITSM 团队通过 Claude / Cursor 让 AI 自动查询和处理 Incident、Change Request
• ServiceNow 管理员用自然语言搜索 CMDB、Knowledge Base、User Group
• DevOps/SRE 在 MCP 客户端里查变更窗口、SLA 状态、On-call 排班
• 多 SSO 厂商环境（Okta / Entra ID / 自研 SAML）下的统一 MCP 接入
• Docker 部署的远程 MCP Server，多团队共享访问同一 ServiceNow 实例

适用人群

ServiceNow 管理员、ITSM 团队 Lead、企业 IT 自动化工程师、AI 编程助手重度用户、SRE / DevOps。

工作原理

mfa-servicenow-mcp 是一个 Python 实现的 MCP stdio 服务器。uvx / pip 启动时会在 ~/.config 下生成默认配置，Playwright 子进程负责真实浏览器自动化登录并把 cookie / session 缓存到本地磁盘（后续请求复用）；写入 ServiceNow 时通过其 Table API 与 Import Set API。所有写操作都先返回 dry-run diff，要求调用方显式 confirm='approve' 才真正提交，从而把生产事故风险降到最低。

官方链接

• PyPI 包：https://pypi.org/project/mfa-servicenow-mcp/
• GitHub 仓库：https://github.com/jshsakura/mfa-servicenow-mcp
• GitHub Pages 文档：https://jshsakura.github.io/mfa-servicenow-mcp/
• Docker 镜像：https://ghcr.io/jshsakura/mfa-servicenow-mcp