servicenow平台mcp
全面 模型上下文协议(MCP) ServiceNow的服务器。跨20个工具组提供一套全面的工具,用于平台自检、变更智能、调试、记录管理、ITSM工作流、CMDB操作、服务目录、自动化调查、文档生成和流设计器分析。
快速开始
1.设置环境变量:
export SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
export SERVICENOW_USERNAME=admin
export SERVICENOW_PASSWORD=your-password2.运行服务器:
uvx servicenow-platform-mcp3.连接您的MCP客户端 (参见 配置 在......下面
配置
开源代码
添加 ~/.config/opencode/opencode.json:
{
"mcp": {
"servicenow": {
"type": "local",
"command": ["uvx", "servicenow-platform-mcp"],
"environment": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_USERNAME": "admin",
"SERVICENOW_PASSWORD": "your-password"
}
}
}
}克劳德桌面
添加 claude_desktop_config.json:
{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": ["servicenow-platform-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_USERNAME": "admin",
"SERVICENOW_PASSWORD": "your-password"
}
}
}
}VS代码/光标
添加 .vscode/mcp.json:
{
"servers": {
"servicenow": {
"command": "uvx",
"args": ["servicenow-platform-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_USERNAME": "admin",
"SERVICENOW_PASSWORD": "your-password"
}
}
}
}通用标准
SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
SERVICENOW_USERNAME=admin \
SERVICENOW_PASSWORD=your-password \
uvx servicenow-platform-mcp环境变量
| 变量 | 描述 | 默认值 | 必填 |
|---|---|---|---|
SERVICENOW_INSTANCE_URL | 完整URL(必须以开头 https://) | - | 是 |
SERVICENOW_USERNAME | ServiceNow用户名 | - | 是 |
SERVICENOW_PASSWORD | ServiceNow密码 | - | 是 |
MCP_TOOL_PACKAGE | 要加载的工具包 | full | 没有 |
SERVICENOW_ENV | 环境标签(dev/test/staging/prod) | dev | 没有 |
MAX_ROW_LIMIT | 每次查询的最大行数(1-10000) | 100 | 没有 |
LARGE_TABLE_NAMES_CSV | 需要日期过滤器的表 | syslog,sys_audit,sys_log_transaction,sys_email_log | 没有 |
SCRIPT_ALLOWED_ROOT | 根目录 script_path 在工件写入 | "" (禁用) | 使用时 script_path |
SENTRY_DSN | 用于错误报告的哨兵DSN | "" | 没有 |
SENTRY_ENVIRONMENT | 哨兵环境标签 | 回归 SERVICENOW_ENV | 没有 |
服务器读取 .env 和 .env.local 文件自动。
AI代理设置
将此提示复制并粘贴到您的AI代理(Claude Code、Cursor、OpenCode等):
Install and configure servicenow-platform-mcp by following the instructions here:
https://raw.githubusercontent.com/Xerrion/servicenow-platform-mcp/refs/heads/main/INSTALL.md或阅读 安装指南 直接。
主要特点
- 平台反思 -描述表、查询记录、检查元数据、计算聚合
- 更改情报 -更新集检查、工件差异、审计跟踪、发布说明
- 调试和跟踪 -事件时间线、流执行、电子邮件跟踪、导入集、字段突变
- 记录管理 -带有预览的完整CRUD,然后应用安全模式
- 工件管理 -创建/更新业务规则、脚本包含和15种以上具有本地脚本文件支持的工件类型
- ITSM工作流程 -事件、变更、问题生命周期管理
- CMDB操作 -浏览CI、关系、类和健康检查
- 服务目录 -浏览、订购、购物车管理、结账
- 知识管理 -搜索、创建、更新文章和反馈
- 调查 -对过时的自动化、弃用的API、ACL冲突、性能瓶颈进行自动分析
- 文档生成 -逻辑图、工件摘要、测试场景、审查说明
- 流程设计器 -检查流、操作、执行、快照、迁移分析
工具包
控制装载哪些工具 MCP_TOOL_PACKAGE。有14个预设包:
| 包 | 组 | 描述 |
|---|---|---|
full | 20 | 所有标准工具(默认) |
core_readonly | 4 | 只读核心工具 |
none | 0 | 未加载工具 |
itil | 16 | ITIL流程工具 |
developer | 13 | 以开发为重点的工具 |
readonly | 10 | 只读操作 |
analyst | 8 | 分析和报告 |
incident_management | 9 | 事件生命周期 |
change_management | 8 | 变更请求工具 |
cmdb | 6 | CMDB管理 |
problem_management | 9 | 问题生命周期 |
request_management | 8 | 请求/RITM工具 |
knowledge_management | 6 | 知识库工具 |
service_catalog | 6 | 服务目录工具 |
您还可以使用逗号分隔的组名创建自定义包(例如。 MCP_TOOL_PACKAGE="table,record,debug").请参阅 维基 有关完整软件包和工具组的详细信息。
安全
- 表拒绝列表 -阻止对敏感系统表的访问(
sys_user_has_password,oauth_credential,sys_credentials等等) - 敏感场屏蔽 -密码、令牌、秘密和类似字段会自动屏蔽
- 写控制 -当以下情况发生时,所有写入操作都被阻止
SERVICENOW_ENV设置为prod或production - 行限制和大表保护 -使用可配置的上限和强制日期过滤器防止失控的查询
这些护栏可以降低风险,但不能保证——始终在子生产环境中验证。
请参阅 安全与政策 维基页面以获取完整的详细信息。
发展
git clone https://github.com/Xerrion/servicenow-platform-mcp.git
cd servicenow-platform-mcp
uv sync --group dev
uv run pytest # Run tests
uv run ruff check . # Lint
uv run ruff format . # Format
uv run mypy src/ # Type check