ServiceNow

@mindstone/mcp-server-servicenow

面向 Model Context Protocol 宿主的 ServiceNow ITSM MCP 服务。通过标准化的 MCP 接口，在 ServiceNow 中管理事件、变更请求、用户和知识库文章。

状态

• 版本： 0.3.1 · npm
• 身份验证： 基本身份验证（用户名 + 密码）或 OAuth 2.0 客户端凭据（SERVICENOW_PASSWORD）
• 工具： 13（事件、变更请求、用户、知识、服务目录）
• 类型： 云 API
• 机器可读信息： STATUS.json

要求

• Node.js 20+
• npm

一键安装

点击按钮后，宿主会提示你填写：SERVICENOW_INSTANCE、SERVICENOW_USERNAME、SERVICENOW_PASSWORD、SERVICENOW_CLIENT_SECRET。

{
  "mcpServers": {
    "ServiceNow": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE": "",
        "SERVICENOW_USERNAME": "",
        "SERVICENOW_PASSWORD": "",
        "SERVICENOW_CLIENT_SECRET": ""
      }
    }
  }
}

快速入门

安装与构建

cd <path-to-repo>/connectors/servicenow
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-servicenow

本地

node dist/index.js

配置

环境变量

• SERVICENOW_INSTANCE — ServiceNow 实例名称（例如，acme.service-now.com 对应 acme）
• SERVICENOW_USERNAME — ServiceNow 用户名
• SERVICENOW_PASSWORD — ServiceNow 密码
• SERVICENOW_CLIENT_ID — 可选的 OAuth 2.0 客户端 ID（可替代用户名/密码；见下文）
• SERVICENOW_CLIENT_SECRET — 可选的 OAuth 2.0 客户端密钥
• MCP_HOST_BRIDGE_STATE — 可选的宿主桥接状态文件路径，用于凭据管理
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名

OAuth 2.0（客户端凭据）

强制执行 MFA/SSO 的实例通常会禁用基本身份验证。作为替代方案，连接器支持 OAuth 2.0 客户端凭据授权：

1. 在实例上启用入站客户端凭据授权（系统属性 glide.oauth.inbound.client.credential.grant_type.enabled = true）。
2. 在 System OAuth → Application Registry → New → Create an OAuth API endpoint for external clients 下创建条目，并记下客户端 ID 和密钥。
3. 设置 SERVICENOW_INSTANCE、SERVICENOW_CLIENT_ID 和 SERVICENOW_CLIENT_SECRET（不设置用户名/密码）。

令牌从实例的 oauth_token.do 端点获取，并缓存至即将过期时。若同时配置了两种身份验证方式，则优先使用基本身份验证。

主机配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "ServiceNow": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-servicenow"],
      "env": {
        "SERVICENOW_INSTANCE": "your-instance",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_PASSWORD": "your-password"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "ServiceNow": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/servicenow/dist/index.js"],
      "env": {
        "SERVICENOW_INSTANCE": "your-instance",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_PASSWORD": "your-password"
      }
    }
  }
}

工具（13 个）

配置

• configure_servicenow — 配置 ServiceNow 实例凭据

事件

• list_servicenow_incidents — 列出或搜索事件
• get_servicenow_incident — 按编号或 sys_id 获取单个事件
• create_servicenow_incident — 创建新事件
• update_servicenow_incident — 更新现有事件（包括追加 work_notes / comments 日志条目）

变更请求

• list_servicenow_change_requests — 列出或搜索变更请求
• get_servicenow_change_request — 按编号或 sys_id 获取单个变更请求
• create_servicenow_change_request — 创建新的变更请求

用户

• list_servicenow_users — 列出或搜索用户

知识库

• search_servicenow_knowledge — 搜索知识库文章
• get_servicenow_knowledge_article — 获取完整的知识库文章

服务目录

• list_servicenow_catalog_items — 列出或搜索服务目录条目
• get_servicenow_catalog_item — 按 sys_id 获取单个目录条目

安全性

ServiceNow 返回的所有外部文本（记录描述、工作备注、用户名、文章正文和任何自定义字段）在传递给模型之前，都会封装在 <untrusted-content source="servicenow:...">...</untrusted-content> 中，并进行闭合标签转义，因此第三方内容会被视为数据，而非指令。标识符（sys_id、number）、时间戳和选项列表显示值保持原样，以便复制到后续工具调用中。

许可证

FSL-1.1-MIT — Functional Source License，Version 1.1，未来将采用 MIT 许可证。本软件将于 2030-04-08 转为 MIT 许可证。