内容
[](https://mseep.ai/app/osomai-servicenow-mcp)
# ServiceNow MCP 服务器
ServiceNow 的模型完成协议(MCP)服务器实现,允许 Claude 与 ServiceNow 实例交互。
<a href="https://glama.ai/mcp/servers/@osomai/servicenow-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@osomai/servicenow-mcp/badge" alt="ServiceNow 服务器 MCP 服务器" />
</a>
## 部署
使用以下按钮克隆仓库并直接将服务器部署到 Alpic:
[](https://app.alpic.ai/new/clone?repositoryUrl=https%3A%2F%2Fgithub.com%2Falpic-ai%2Fservicenow-mcp)
## 概述
该项目实现了 MCP 服务器,启用 Claude 连接到 ServiceNow 实例,检索数据,并通过 ServiceNow API 执行操作。它作为 Claude 和 ServiceNow 之间的桥梁,允许无缝集成。
服务器支持多种传输模式:
- **可流式 HTTP**(默认,兼容 Alpic)- 适用于云部署的无状态 HTTP 传输
- **服务器发送事件(SSE)** - 通过 Starlette/Uvicorn 进行基于 Web 的集成
- **stdio** - 用于本地 Claude Desktop 集成
## 功能
- 使用各种身份验证方法(基本身份验证、OAuth、API 密钥)连接到 ServiceNow 实例
- 查询 ServiceNow 记录和表
- 创建、更新和删除 ServiceNow 记录
- 执行 ServiceNow 脚本和工作流
- 访问和查询 ServiceNow 服务目录
- 分析和优化 ServiceNow 服务目录
- 全面的资产管理(创建、更新、转移、删除资产)
- 用于故障排除的调试模式
- 支持 stdio 和服务器发送事件(SSE)通信
## 安装
### 先决条件
- Python 3.11 或更高版本
- 具有适当访问凭据的 ServiceNow 实例
### 设置
1. 克隆此仓库:
```bash
git clone https://github.com/yourusername/servicenow-mcp.git
cd servicenow-mcp
```
2. 创建虚拟环境并安装包:
```bash
python -m venv .venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate
pip install -e .
```
3. 使用您的 ServiceNow 凭证创建 `.env` 文件:
```bash
SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
SERVICENOW_AUTH_TYPE=basic # 或 oauth,api_key
```
## 使用
### 流式 HTTP 模式(兼容 Alpic)
推荐用于云部署和 Alpic。服务器作为具有流式 HTTP 传输的 HTTP 端点运行。
#### 启动 HTTP 服务器
```bash
# 使用 uv(推荐)
uv run main.py
# 或使用显式环境变量
SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
SERVICENOW_USERNAME=your-username \
SERVICENOW_PASSWORD=your-password \
SERVICENOW_AUTH_TYPE=basic \
uv run main.py
```
默认情况下,服务器监听端口 `3000`(可通过设置 `PORT` 环境变量来覆盖)。
服务器在以下位置公开 MCP 端点:
- `POST /mcp` - 流式 HTTP 传输的主要 MCP 消息端点
#### HTTP 模式环境变量
| 变量 | 是否必需 | 描述 |
| --- | --- | --- |
| `SERVICENOW_INSTANCE_URL` | 是 | ServiceNow 实例 URL |
| `SERVICENOW_USERNAME` | 是* | 基本身份验证的用户名 |
| `SERVICENOW_PASSWORD` | 是* | 基本身份验证的密码 |
| `SERVICENOW_AUTH_TYPE` | 否 | 身份验证类型:`basic`、`oauth`、`api_key`(默认:`basic`) |
| `SERVICENOW_CLIENT_ID` | 是** | OAuth 客户端 ID |
| `SERVICENOW_CLIENT_SECRET` | 是** | OAuth 客户端密钥 |
| `SERVICENOW_API_KEY` | 是*** | API 密钥身份验证的 API 密钥 |
| `SERVICENOW_DEBUG` | 否 | 启用调试日志(`true`/`false`) |
| `MCP_TOOL_PACKAGE` | 否 | 要加载的工具包(默认:`full`) |
| `PORT` | 否 | HTTP 服务器端口(默认:`3000`) |
\* 基本身份验证必填。\*\* OAuth 必填。\*\*\* API 密钥身份验证必填。
> **Alpic 部署注意:** 这些环境变量被配置为 **服务器端部署设置**,在您的 Alpic 项目中(仪表盘 → 环境 → 环境变量)。它们不由连接到您的服务器的单个 MCP 客户端提供。每个 Alpic 环境都可以指向不同的 ServiceNow 实例,从而轻松维护单独的开发/预发布/生产部署。对于共享团队使用,请在每个环境中配置一次凭证,并与您的团队共享部署 URL。
### 标准(stdio)模式
启动 MCP 服务器:
```bash
python -m servicenow_mcp.cli
# 或
uv run servicenow-mcp-sse --host=127.0.0.1 --port=8000
```
或使用环境变量:
```bash
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 服务器也可以作为 Web 服务器运行,使用服务器发送事件(SSE)进行通信,从而提供更灵活的集成选项。
#### 启动 SSE 服务器
您可以使用提供的 CLI 启动 SSE 服务器:
```bash
servicenow-mcp-sse --instance-url=https://your-instance.service-now.com --username=your-username --password=your-password
```
默认情况下,服务器将监听 `0.0.0.0:8080`。您可以自定义主机和端口:
```bash
servicenow-mcp-sse --host=127.0.0.1 --port=8000
```
#### 连接到 SSE 服务器
SSE 服务器公开两个主要端点:
- `/sse` - SSE 连接端点
- `/messages/` - 向服务器发送消息的端点
#### 示例
参见 `examples/sse_server_example.py` 文件,了解设置和运行 SSE 服务器的完整示例。
```python
from servicenow_mcp.server import ServiceNowMCP
from servicenow_mcp.server_sse import create_starlette_app
from servicenow_mcp.utils.config import ServerConfig, AuthConfig, AuthType, BasicAuthConfig
import uvicorn
# 创建服务器配置
config = ServerConfig(
instance_url="https://your-instance.service-now.com",
auth=AuthConfig(
type=AuthType.BASIC,
config=BasicAuthConfig(
username="your-username",
password="your-password"
)
),
debug=True,
)
# 创建 ServiceNow MCP 服务器
servicenow_mcp = ServiceNowMCP(config)
# 使用 SSE 传输创建 Starlette 应用
app = create_starlette_app(servicenow_mcp, debug=True)
# 启动 Web 服务器
uvicorn.run(app, host="0.0.0.0", port=8080)
```
## 工具打包(可选)
为了管理暴露给语言模型的工具数量(尤其是在具有限制的环境中),ServiceNow MCP 服务器支持加载称为“包”的工具子集。通过 `MCP_TOOL_PACKAGE` 环境变量控制此功能。
### 配置
1. **环境变量:** 将 `MCP_TOOL_PACKAGE` 环境变量设置为所需包的名称。
```bash
export MCP_TOOL_PACKAGE=catalog_builder
```
2. **包定义:** 可用的包和它们包含的工具在 `config/tool_packages.yaml` 中定义。您可以自定义此文件以创建自己的包。
### 行为
- 如果将 `MCP_TOOL_PACKAGE` 设置为 `config/tool_packages.yaml` 中定义的合法包名称,则仅加载该包中列出的工具。
- 如果 `MCP_TOOL_PACKAGE` **未设置** 或为空,则默认加载 `full` 包(包含所有工具)。
- 如果将 `MCP_TOOL_PACKAGE` 设置为无效的包名称,则加载 `none` 包(除 `list_tool_packages` 外不加载任何工具),并记录警告。
- 显式设置 `MCP_TOOL_PACKAGE=none` 加载除 `list_tool_packages` 外的任何工具。
### 可用包(默认)
默认的 `config/tool_packages.yaml` 包括以下基于角色的包:
- `service_desk`:用于事件处理和基本用户/知识查找的工具。
- `catalog_builder`:用于创建和管理服务目录项、类别、变量和相关脚本(UI 策略、用户标准)的工具。
- `change_coordinator`:用于管理变更请求生命周期的工具,包括任务和审批。
- `knowledge_author`:用于创建和管理知识库、类别和文章的工具。
- `platform_developer`:用于服务器端脚本(Script Includes)、工作流开发和部署(Changesets)的工具。
- `system_administrator`:用于用户/组管理和查看系统日志的工具。
- `agile_management`:用于管理用户故事、史诗、Scrum 任务和项目的工具。
- `full`:包括所有可用工具(默认)。
- `none`:包括除 `list_tool_packages` 之外的任何工具。
### 内省工具
- **`list_tool_packages`**:列出 `config/tool_packages.yaml` 中定义的所有可用工具包名称,并显示当前加载的包。此工具在除 `none` 之外的所有包中均可用。
## 可用工具
**注意:** 以下工具的可用性取决于加载的工具包(参见上面的工具打包部分)。默认情况下(`full` 包),所有工具都可用。
#### 事件管理工具
1. **create_incident** - 在 ServiceNow 中创建新的事件
2. **update_incident** - 更新 ServiceNow 中的现有事件
3. **add_comment** - 在 ServiceNow 中向事件添加评论
4. **resolve_incident** - 在 ServiceNow 中解决事件
5. **list_incidents** - 从 ServiceNow 列出事件
#### 服务目录工具
1. **list_catalog_items** - 从 ServiceNow 列出服务目录项
2. **get_catalog_item** - 从 ServiceNow 获取特定的服务目录项
3. **list_catalog_categories** - 从 ServiceNow 列出服务目录类别
4. **create_catalog_category** - 在 ServiceNow 中创建新的服务目录类别
5. **update_catalog_category** - 更新 ServiceNow 中的现有服务目录类别
6. **move_catalog_items** - 在 ServiceNow 中将目录项移动到不同类别
7. **create_catalog_item_variable** - 为目录项创建新的变量(表单字段)
8. **list_catalog_item_variables** - 列出目录项的所有变量
9. **update_catalog_item_variable** - 更新目录项的现有变量
10. **list_catalogs** - 从 ServiceNow 列出服务目录
#### 目录优化工具
1. **get_optimization_recommendations** - 获取服务目录优化建议
2. **update_catalog_item** - 更新服务目录项
#### 变更管理工具
1. **create_change_request** - 在 ServiceNow 中创建新的变更请求
2. **update_change_request** - 更新现有的变更请求
3. **list_change_requests** - 列出变更请求并提供筛选选项
4. **get_change_request_details** - 获取特定变更请求的详细信息
5. **add_change_task** - 向变更请求添加任务
6. **submit_change_for_approval** - 提交变更请求审批
7. **approve_change** - 批准变更请求
8. **reject_change** - 拒绝变更请求
#### 敏捷管理工具
##### 故事管理
1. **create_story** - 在 ServiceNow 中创建新的用户故事
2. **update_story** - 更新 ServiceNow 中的现有用户故事
3. **list_stories** - 列出 ServiceNow 中的用户故事并提供筛选选项
4. **create_story_dependency** - 在两个故事之间创建依赖关系
5. **delete_story_dependency** - 删除故事之间的依赖关系
##### 史诗管理
1. **create_epic** - 在 ServiceNow 中创建新的史诗
2. **update_epic** - 更新 ServiceNow 中的现有史诗
3. **list_epics** - 从 ServiceNow 列出史诗并提供筛选选项
##### Scrum 任务管理
1. **create_scrum_task** - 在 ServiceNow 中创建新的 Scrum 任务
2. **update_scrum_task** - 更新 ServiceNow 中的现有 Scrum 任务
3. **list_scrum_tasks** - 从 ServiceNow 列出 Scrum 任务并提供筛选选项
##### 项目管理
1. **create_project** - 在 ServiceNow 中创建新的项目
2. **update_project** - 更新 ServiceNow 中的现有项目
3. **list_projects** - 从 ServiceNow 列出项目并提供筛选选项
#### 资产管理工具
1. **create_asset** - 使用详细属性在 ServiceNow 中创建新的资产
2. **update_asset** - 更新现有资产的信息
3. **get_asset** - 通过 ID、标签或序列号检索特定资产
4. **list_assets** - 列出资产并提供灵活的筛选和分页
5. **search_assets_by_name** - 使用 LIKE 匹配通过显示名称搜索资产
6. **delete_asset** - 从 ServiceNow 删除资产
7. **transfer_asset** - 将资产转移到不同的用户并带有审计跟踪
8. **list_hardware_assets** - 从 alm_hardware 表列出硬件资产并提供灵活的筛选和分页
#### 问题工具
1. **create_problem** - 在 ServiceNow 中创建新的问题
#### 工作流管理工具
1. **list_workflows** - 从 ServiceNow 列出工作流
2. **get_workflow** - 从 ServiceNow 获取特定的工作流
3. **create_workflow** - 在 ServiceNow 中创建新的工作流
4. **update_workflow** - 更新 ServiceNow 中的现有工作流
5. **delete_workflow** - 从 ServiceNow 删除工作流
#### 脚本包含管理工具
1. **list_script_includes** - 从 ServiceNow 列出脚本包含
2. **get_script_include** - 从 ServiceNow 获取特定的脚本包含
3. **create_script_include** - 在 ServiceNow 中创建新的脚本包含
4. **update_script_include** - 更新 ServiceNow 中的现有脚本包含
5. **delete_script_include** - 从 ServiceNow 删除脚本包含
#### 变更集管理工具
1. **list_changesets** - 列出 ServiceNow 中的变更集并提供筛选选项
2. **get_changeset_details** - 获取特定变更集的详细信息
3. **create_changeset** - 在 ServiceNow 中创建新的变更集
4. **update_changeset** - 更新现有的变更集
5. **commit_changeset** - 提交变更集
6. **publish_changeset** - 发布变更集
7. **add_file_to_changeset** - 将文件添加到变更集
#### 知识库管理工具
1. **create_knowledge_base** - 在 ServiceNow 中创建新的知识库
2. **list_knowledge_bases** - 列出知识库并提供筛选选项
3. **create_category** - 在知识库中创建新的类别
4. **create_article** - 在 ServiceNow 中创建新的知识文章
5. **update_article** - 更新 ServiceNow 中的现有知识文章
6. **publish_article** - 在 ServiceNow 中发布知识文章
7. **list_articles** - 列出知识文章并提供筛选选项
8. **get_article** - 通过 ID 获取特定的知识文章
#### 用户管理工具
1. **create_user** - 在 ServiceNow 中创建新的用户
2. **update_user** - 更新 ServiceNow 中的现有用户
3. **get_user** - 通过 ID、用户名或电子邮件获取特定的用户
4. **list_users** - 列出用户并提供筛选选项
5. **create_group** - 在 ServiceNow 中创建新的组
6. **update_group** - 更新 ServiceNow 中的现有组
7. **add_group_members** - 在 ServiceNow 中向组添加成员
8. **remove_group_members** - 在 ServiceNow 中从组中删除成员
9. **list_groups** - 列出组并提供筛选选项
#### UI 策略工具
1. **create_ui_policy** - 创建 ServiceNow UI 策略,通常用于目录项。
2. **create_ui_policy_action** - 创建与 UI 策略相关的操作,以控制变量状态(可见性、必填等)。
### 使用 MCP CLI
ServiceNow MCP 服务器可以使用 MCP CLI 安装,MCP CLI 提供了一种便捷的方式将服务器注册到 Claude。
```bash
# 使用 .env 文件中的环境变量安装 ServiceNow MCP 服务器
mcp install src/servicenow_mcp/server.py -f .env
```
此命令将使用 .env 文件中的环境变量注册 ServiceNow MCP 服务器到 Claude,并配置它使用它们。
### 与 Claude Desktop 集成
在 Claude Desktop 中配置 ServiceNow MCP 服务器:
1. 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`(macOS)或适用于您操作系统的相应路径:
```json
{
"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"
}
}
}
}
```
2. 重启 Claude Desktop 以应用更改
### 与 Claude 的示例用法
以下是一些示例自然语言查询,您可以使用它们通过 MCP 服务器与 ServiceNow 交互:
#### 事件管理示例
- “在东区创建一个新的网络中断事件”
- “将事件 INC0010001 的优先级设置为高”
- “在事件 INC0010001 中添加评论,说明问题正在调查中”
- “解决事件 INC0010001,并附上服务器已重启的说明”
- “列出网络团队的所有高优先级事件”
- “列出网络团队的所有活动 P1 事件。”
#### 服务目录示例
- "显示服务目录中的所有项目"
- "列出服务目录的所有类别"
- "获取笔记本电脑请求目录项目的详细信息"
- "显示硬件类别中的所有目录项目"
- "在服务目录中搜索 '软件'"
- "在服务目录中创建一个名为 '云服务' 的新类别"
- "更新 '硬件' 类别,将其重命名为 'IT 设备'"
- "将 '虚拟机' 目录项目移动到 '云服务' 类别"
- "在 'IT 设备' 类别下创建一个名为 '显示器' 的子类别"
- "重新组织我们的目录,将所有软件项目移动到 '软件' 类别"
- "为笔记本电脑请求目录项目创建描述字段"
- "为选择笔记本电脑型号到目录项目添加下拉字段"
- "列出 VPN 访问请求目录项目的所有表单字段"
- "使软件请求表单中的部门字段成为必填项"
- "更新成本中心字段的帮助文本"
- "显示系统中的所有服务目录"
- "列出所有硬件目录项目。"
- "查找 '新笔记本电脑请求' 的目录项目。"
- "显示 '新笔记本电脑请求' 项目的变量。"
- "为 '新员工设置' 目录项目创建一个名为 '部门代码' 的新变量。使其成为必填字符串字段。"
#### 目录优化示例
- "分析我们的服务目录并找出改进机会"
- "查找需要改进的描述不佳的目录项目"
- "识别使用率低的目录项目,以便我们考虑淘汰"
- "查找放弃率高的目录项目"
- "优化我们的硬件类别以改善用户体验"
#### 变更管理示例
- "为服务器维护创建变更请求,以在明晚应用安全补丁"
- "计划下周二凌晨 2 点至 4 点进行数据库升级"
- "为服务器维护变更添加任务,进行预实施检查"
- "提交服务器维护变更以审批"
- "批准数据库升级变更,评论:实施计划看起来很完善"
- "显示本周安排的所有紧急变更"
- "列出分配给网络团队的所有变更"
- "创建一个正常变更请求,以升级生产数据库服务器。"
- "更新变更 CHG0012345,设置状态为 '实施'。"
#### 敏捷管理示例
- "为实施新报告仪表板创建一个新的用户故事"
- "更新 '实施新报告仪表板' 故事,设置为阻塞"
- "列出分配给数据分析团队的所有用户故事"
- "在 '实施新报告仪表板' 故事和 '开发数据提取管道' 故事之间创建依赖关系"
- "删除 '实施新报告仪表板' 故事和 '开发数据提取管道' 故事之间的依赖关系"
- "创建一个名为 '数据分析计划' 的新史诗"
- "更新 '数据分析计划' 史诗,设置为已完成"
- "列出 '数据分析' 项目中的所有史诗"
- "为 '实施新报告仪表板' 故事创建一个新的敏捷任务"
- "更新 '开发数据提取管道' 敏捷任务,设置为已完成"
- "列出 '实施新报告仪表板' 故事中的所有敏捷任务"
- "创建一个名为 '数据分析计划' 的新项目"
- "更新 '数据分析计划' 项目,设置为已完成"
- "列出 '数据分析' 史诗中的所有项目"
#### 工作流管理示例
- "显示 ServiceNow 中所有活动的工作流"
- "获取事件审批工作流的详细信息"
- "列出变更请求工作流的所有版本"
- "显示服务目录请求工作流中的所有活动"
- "为软件许可请求创建一个新的工作流"
- "更新事件升级工作流的描述"
- "激活新员工入职工作流"
- "停用旧密码重置工作流"
- "为软件许可请求工作流添加审批活动"
- "更新事件升级工作流中的通知活动"
- "从变更请求工作流中删除不必要的活动"
- "重新排序服务目录请求工作流中的活动"
#### 变更集管理示例
- "列出 ServiceNow 中的所有变更集"
- "显示由开发者 'john.doe' 创建的所有变更集"
- "获取变更集 'sys_update_set_123' 的详细信息"
- "为 'HR 门户' 应用程序创建一个新的变更集"
- "更新变更集 'sys_update_set_123' 的描述"
- "提交变更集 'sys_update_set_123',附带消息 '修复登录问题'"
- "将变更集 'sys_update_set_123' 发布到生产环境"
- "为变更集 'sys_update_set_123' 添加文件"
- "显示变更集 'sys_update_set_123' 中的所有变更"
#### 知识库示例
- "为 IT 部门创建一个新的知识库"
- "列出组织中的所有知识库"
- "在 IT 知识库中创建一个名为 '网络故障排除' 的类别"
- "在网络故障排除类别中编写一篇关于 VPN 设置的文章"
- "更新 VPN 设置文章以包含移动设备说明"
- "发布 VPN 设置文章,以便所有用户都可以看到"
- "列出网络故障排除类别中的所有文章"
- "显示 VPN 设置文章的详细信息"
- "在 IT 知识库中找到包含 '密码重置' 的知识文章"
- "在网络故障排除类别下创建一个名为 '无线网络' 的子类别"
#### 用户管理示例
- "在放射科部门为 Dr. Alice 创建一个新用户"
- "更新 Bob 的用户记录,使他成为 Alice 的经理"
- "为 Bob 赋予 ITIL 角色,以便他可以审批变更请求"
- "列出放射科部门的所有用户"
- "为医疗设备管理创建一个名为 '生物医学工程' 的新组"
- "将管理员用户添加为生物医学工程组的成员"
- "更新生物医学工程组以更改其经理"
- "从生物医学工程组中删除用户"
- "查找系统中所有职称包含 '医生' 的活跃用户"
- "为放射科部门创建一个用户,作为审批者"
- "列出系统中的所有 IT 支持组"
#### UI 策略示例
- "为 '软件请求' 项目(sys_id: abc...)创建一个名为 '显示理由' 的 UI 策略,当 'software_cost' 大于 100 时应用。"
- "对于 UI 策略 '显示理由'(sys_id: def...),添加一个操作,使 'business_justification' 变量可见且必填。"
- "为策略 '显示理由' 创建另一个操作,以隐藏 'alternative_software' 变量。"
### 示例脚本
存储库中包含示例脚本,以演示如何使用这些工具:
- **examples/asset_management_demo.py**:资产管理的综合演示
- **examples/catalog_optimization_example.py**:演示如何分析和改进 ServiceNow 服务目录
- **examples/change_management_demo.py**:演示如何在 ServiceNow 中创建和管理变更请求
## 认证方法
### 基本认证
```
SERVICENOW_AUTH_TYPE=basic
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
```
### OAuth 认证
```
SERVICENOW_AUTH_TYPE=oauth
SERVICENOW_CLIENT_ID=your-client-id
SERVICENOW_CLIENT_SECRET=your-client-secret
SERVICENOW_TOKEN_URL=https://your-instance.service-now.com/oauth_token.do
```
### API 密钥认证
```
SERVICENOW_AUTH_TYPE=api_key
SERVICENOW_API_KEY=your-api-key
```
## 开发
### 文档
在 `docs` 目录中提供其他文档:
- [资产管理](docs/asset_management.md) - 资产管理功能的综合指南
- [目录集成](docs/catalog.md) - 关于服务目录集成的详细信息
- [目录优化](docs/catalog_optimization_plan.md) - 目录优化功能的详细计划
- [变更管理](docs/change_management.md) - 关于变更管理工具的详细信息
- [工作流管理](docs/workflow_management.md) - 关于工作流管理工具的详细信息
- [变更集管理](docs/changeset_management.md) - 关于变更集管理工具的详细信息
### 故障排除
#### 变更管理工具常见错误
1. **错误:`** `argument after ** must be a mapping, not CreateChangeRequestParams`**
- 此错误发生在将 `CreateChangeRequestParams` 对象而不是字典传递给 `create_change_request` 函数时。
- 解决方案:确保传递的是字典而不是 Pydantic 模型对象。
- 注意:变更管理工具已更新以自动处理此错误。如果参数包装不正确或作为 Pydantic 模型对象传递,函数将尝试解包参数。
2. **错误:`** `Missing required parameter 'type'`
- 此错误发生在创建变更请求时未提供所有必需参数时。
- 解决方案:确保包含所有必需参数。对于 `create_change_request`,`short_description` 和 `type` 都是必需的。
3. **错误:`** `Invalid value for parameter 'type'`
- 此错误发生在提供无效的 `type` 参数值时。
- 解决方案:使用有效值之一: "normal", "standard", 或 "emergency".
4. **错误:`** `Cannot find get_headers method in either auth_manager or server_config`**
- 此错误发生在参数传递顺序错误或使用没有所需方法的对象时。
- 解决方案:确保按正确顺序传递 `auth_manager` 和 `server_config` 参数。函数已更新以自动处理参数交换。
### 贡献
欢迎贡献!请随时提交拉取请求。
1. 分叉存储库
2. 创建功能分支(`git checkout -b feature/amazing-feature`)
3. 提交更改(`git commit -m 'Add some amazing feature'`)
4. 推送到分支(`git push origin feature/amazing-feature`)
5. 打开拉取请求
### 许可证
该项目根据 MIT 许可证授权 - 有关详细信息,请参见 LICENSE 文件。
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器