ServiceNow MCP Server

什么是 ServiceNow MCP Server？

ServiceNow MCP Server 是一个由社区开发、使用 Python 编写的 servicenow mcp server，可让 Claude 及其他 MCP 客户端查询和修改 ServiceNow 实例中的记录。它覆盖事件（incident）、服务目录、变更请求、敏捷工作、知识库、用户等领域。

该项目以 MIT 许可证开源，并非 ServiceNow 官方发布。它通过 ServiceNow API 与你的实例通信，支持 Basic、OAuth 或 API key 认证，既可以通过 stdio 在本地运行，也可以作为基于 Server-Sent Events（SSE）的小型 Web 服务器运行。

如何使用 ServiceNow MCP Server？

你需要 Python 3.11 或更高版本，以及一个 ServiceNow 实例和具备相应权限的凭据（权限范围即你希望 AI 拥有的权限）。

克隆仓库并安装到虚拟环境中（mcp.so 列表指向 osomai/servicenow-mcp，该地址会重定向到这个仓库）：

git clone https://github.com/echelon-ai-labs/servicenow-mcp.git
cd servicenow-mcp
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

创建 .env 文件，填写实例 URL 和凭据：

SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
SERVICENOW_AUTH_TYPE=basic  # or oauth, api_key

使用 python -m servicenow_mcp.cli 以 stdio 模式启动服务器，或将其作为 SSE Web 服务器运行：

servicenow-mcp-sse --instance-url=https://your-instance.service-now.com --username=your-username --password=your-password

SSE 服务器默认监听 0.0.0.0:8080（可通过 --host 和 --port 修改），并提供 /sse 和 /messages/ 两个端点。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或你所用系统对应的文件，将 command 指向虚拟环境中的 Python，然后重启 Claude Desktop：

{
  "mcpServers": {
    "ServiceNow": {
      "command": "/Users/yourusername/dev/servicenow-mcp/.venv/bin/python",
      "args": ["-m", "servicenow_mcp.cli"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_PASSWORD": "your-password",
        "SERVICENOW_AUTH_TYPE": "basic"
      }
    }
  }
}

README 还介绍了通过 MCP CLI 注册服务器的方法：mcp install src/servicenow_mcp/server.py -f .env。

Claude Code

使用环境变量注册同一条命令：

claude mcp add servicenow \
  -e SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
  -e SERVICENOW_USERNAME=your-username \
  -e SERVICENOW_PASSWORD=your-password \
  -e SERVICENOW_AUTH_TYPE=basic \
  -- /path/to/servicenow-mcp/.venv/bin/python -m servicenow_mcp.cli

Cursor

将上面 Claude Desktop 示例中的 mcpServers 配置块添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json），并使用虚拟环境中 Python 的绝对路径。

ServiceNow MCP Server 的主要功能

• 三种认证方式：Basic（SERVICENOW_USERNAME/SERVICENOW_PASSWORD）、OAuth（SERVICENOW_CLIENT_ID、SERVICENOW_CLIENT_SECRET、SERVICENOW_TOKEN_URL）以及 API key（SERVICENOW_API_KEY）。
• 在 ITSM 和平台各领域查询、创建、更新和删除 ServiceNow 记录。
• 访问服务目录，并提供目录分析与优化建议。
• 完整的变更管理生命周期，包括任务、提交审批、批准和拒绝。
• 面向平台开发者的 Script Include、工作流和 changeset（update set）管理。
• 通过 MCP_TOOL_PACKAGE 提供基于角色的工具包，限制模型可见的工具数量。
• 支持 stdio 和 SSE 传输，并提供用于排查问题的调试模式。

ServiceNow MCP Server 工具

默认加载的 full 工具包包含所有工具。工具按领域分组：

• 事件管理：create_incident、update_incident、add_comment、resolve_incident、list_incidents。
• 服务目录与优化：list_catalog_items、create_catalog_category、move_catalog_items、create_catalog_item_variable、get_optimization_recommendations。
• 变更管理：create_change_request、add_change_task、submit_change_for_approval、approve_change、reject_change。
• 敏捷：用户故事、史诗、Scrum 任务和项目，例如 create_story 和 create_story_dependency。
• 平台开发：工作流、Script Include（create_script_include）和 changeset（commit_changeset、publish_changeset）。
• 知识库：create_knowledge_base、create_article、publish_article、list_articles。
• 用户、群组和 UI 策略：create_user、add_group_members、create_ui_policy、create_ui_policy_action。

如需精简工具列表，可将 MCP_TOOL_PACKAGE 设置为 service_desk、catalog_builder、change_coordinator、knowledge_author、platform_developer、system_administrator 或 agile_management 之一。工具包定义在 config/tool_packages.yaml 中，list_tool_packages 可显示当前加载的工具包。

ServiceNow MCP Server 的使用场景

• 服务台分派：“List all active P1 incidents assigned to the Network team.”（列出分配给 Network 团队的所有活动 P1 事件）
• 更新工单：“Resolve incident INC0010001 with a note that the server was restarted.”（解决事件 INC0010001，并备注服务器已重启）
• 变更协调：“Create a change request for server maintenance to apply security patches tomorrow night”（为明晚应用安全补丁的服务器维护创建变更请求），然后提交审批。
• 构建服务目录：“Add a dropdown field for selecting laptop models to catalog item.”（为目录项添加选择笔记本型号的下拉字段）
• 编写知识库：“Write an article about VPN setup in the Network Troubleshooting category”（在 Network Troubleshooting 分类下撰写一篇 VPN 设置文章）并发布。
• 平台开发：“Commit changeset 'sys_update_set_123' with message 'Fixed login issue'.”（提交 changeset 'sys_update_set_123'，备注 'Fixed login issue'）

ServiceNow MCP Server 与替代方案对比

ServiceNow 官方提供 MCP Server Console，这是一款官方应用（在 Australia 版本中推出，随 Now Assist 应用提供），管理员可以在实例上定义 MCP 服务器和工具，客户端通过 OAuth 2.0 连接。如果你需要厂商支持、受治理的 servicenow mcp 方案并具备相应许可，可以选择它。而这个社区服务器无需额外的 ServiceNow 许可，提供现成的 ITSM 和开发者工具，但需要你自行运行和保障安全。

此外还有其他社区方案，例如 mcp.so 上单独收录的 Servicenow MCP Server，它是另一个不同的项目。

ServiceNow MCP Server 常见问题排查

• 创建变更时出现 Missing required parameter 'type'：create_change_request 同时需要 short_description 和 type。
• Invalid value for parameter 'type'：请使用 normal、standard 或 emergency。
• 没有出现任何工具：MCP_TOOL_PACKAGE 名称无效时会加载 none 工具包（只有 list_tool_packages）并记录警告。取消设置该变量即可加载 full。
• Claude Desktop 无法启动服务器：command 必须是你执行过 pip install -e . 的虚拟环境中 Python 的绝对路径。修改配置后请重启 Claude Desktop。
• 需要更多细节：使用 --debug 或 SERVICENOW_DEBUG=true 开启调试模式。