ServiceNow MCP Server

基本能力

产品定位

ServiceNow MCP Server 是一个中间件服务，专注于在 Claude 和 ServiceNow 平台之间建立高效的通信和数据交互通道。

核心功能

• 支持多种认证方式连接 ServiceNow 实例（Basic、OAuth、API Key）
• 查询 ServiceNow 记录和表格
• 创建、更新和删除 ServiceNow 记录
• 执行 ServiceNow 脚本和工作流
• 访问和查询 ServiceNow 服务目录
• 分析和优化 ServiceNow 服务目录
• 调试模式用于故障排除
• 支持 stdio 和 Server-Sent Events (SSE) 通信

适用场景

• IT 服务管理自动化
• 服务目录优化和管理
• 变更管理流程自动化
• 知识库内容管理
• 用户和组管理自动化

工具列表

事件管理工具

• create_incident: 创建新事件
• update_incident: 更新现有事件
• add_comment: 添加事件评论
• resolve_incident: 解决事件
• list_incidents: 列出事件

服务目录工具

• list_catalog_items: 列出服务目录项
• get_catalog_item: 获取特定目录项
• list_catalog_categories: 列出目录类别
• create_catalog_category: 创建新目录类别
• update_catalog_category: 更新目录类别
• move_catalog_items: 移动目录项

变更管理工具

• create_change_request: 创建变更请求
• update_change_request: 更新变更请求
• list_change_requests: 列出变更请求
• get_change_request_details: 获取变更详情
• add_change_task: 添加变更任务

知识库管理工具

• create_knowledge_base: 创建知识库
• list_knowledge_bases: 列出知识库
• create_article: 创建知识文章
• update_article: 更新知识文章
• publish_article: 发布知识文章

常见问题解答

1. 参数传递错误：确保传递字典而非 Pydantic 模型对象
2. 缺少必要参数：创建变更请求时需要提供 short_description 和 type
3. 无效参数值：变更类型必须为 "normal", "standard" 或 "emergency"
4. 认证错误：检查认证参数顺序和配置

使用教程

使用依赖

• Python 3.11 或更高版本
• 具有适当访问权限的 ServiceNow 实例

安装教程

1. 克隆仓库:

git clone https://github.com/yourusername/servicenow-mcp.git
cd servicenow-mcp

1. 创建虚拟环境并安装包:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

1. 创建 .env 文件:

SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
SERVICENOW_AUTH_TYPE=basic

调试方式

标准模式启动:

python -m servicenow_mcp.cli

SSE 模式启动:

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

测试连接:

curl http://localhost:8080/sse

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。