基本能力
产品定位
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: 发布知识文章
常见问题解答
- 参数传递错误：确保传递字典而非 Pydantic 模型对象
- 缺少必要参数：创建变更请求时需要提供 short_description 和 type
- 无效参数值：变更类型必须为 "normal", "standard" 或 "emergency"
- 认证错误：检查认证参数顺序和配置
使用教程
使用依赖
- Python 3.11 或更高版本
- 具有适当访问权限的 ServiceNow 实例
安装教程
-
克隆仓库:
git clone https://github.com/yourusername/servicenow-mcp.git
cd servicenow-mcp -
创建虚拟环境并安装包:
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e . -
创建 .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
