Servicenow MCP

🚀 服務現在工具文檔

本項目提供了與 ServiceNow 系統進行交互的工具和腳本，能有效解決與 ServiceNow 系統集成、管理和操作過程中的各類問題，為用戶帶來便捷、高效的使用體驗。

🚀 快速開始

本項目提供了一系列與 ServiceNow 系統交互的工具和腳本，涵蓋服務目錄集成、變更管理等多個方面。以下是快速瞭解和使用項目的指引。

✨ 主要特性

• 服務目錄集成：集成並管理 ServiceNow 服務目錄。
• 目錄優化：提供優化服務目錄的功能。
• 變更管理：創建、管理和操作變更請求。
• 工作流管理：設計和執行工作流。
• 變更集管理：管理多個變更請求的集合。
• 知識庫集成：集成和服務知識庫文章。
• 用戶管理：創建、更新和管理用戶及組。

💻 使用示例

基礎用法

項目包含演示腳本，展示如何使用工具：

# examples/catalog_optimization_example.py: 展示如何分析並改進ServiceNow服務目錄
# examples/change_management_demo.py: 展示如何創建和管理變更請求

📦 安裝指南

文檔未提及安裝步驟，故跳過此章節。

📚 詳細文檔

更多文檔可在docs目錄中找到：

• 服務目錄集成 - 詳細說明服務目錄集成信息
• 目錄優化計劃 - 詳細的目錄優化功能規劃
• 變更管理 - 詳細說明變更管理工具
• 工作流管理 - 詳細說明工作流管理工具
• 變更集管理 - 詳細說明變更集管理工具

🔧 技術細節

認證方法

基本身份認證

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

故障排除

變更管理工具常見錯誤

1. 錯誤: argument after ** must be a mapping, not CreateChangeRequestParams
   • 這個錯誤發生在將CreateChangeRequestParams對象而不是字典傳遞給create_change_request函數時。
   • 解決方案: 確保傳遞一個參數字典，而不是 Pydantic 模型對象。
   • 注意: 變更管理工具已更新以自動處理此錯誤。函數現在會嘗試自動拆解參數，即使它們被錯誤地包裝或傳遞為 Pydantic 模型對象。
2. 錯誤: 缺少必需的'短描述'參數
   • 這個錯誤發生在未提供創建變更請求所需的所有參數時。
   • 解決方案: 確保包含所有必需參數。對於create_change_request，short_description和type都是必需的。
3. 錯誤: 無效的'type'參數值
   • 這個錯誤發生在傳遞給type參數的值無效時。
   • 解決方案: 使用一個有效的值:"normal"、"standard"或"emergency"。
4. 錯誤: 無法在 auth_manager 或 server_config 中找到 get_headers 方法
   • 這個錯誤發生在認證配置不正確時。
   • 解決方案: 檢查並確保auth_manager和server_config的配置正確。參考認證文檔進行設置。

🤝 貢獻指南

如何貢獻代碼

1. 克隆倉庫：使用 Git 克隆此倉庫。
2. 創建功能分支：為新功能或修復創建新的分支。
3. 提交更改：提交您的更改並添加詳細的提交信息。
4. 推送請求：將分支推送到主倉庫以發起合併請求。

如何報告問題

• 通過 Issues 頁面報告問題，包括詳細的問題描述和復現步驟。

📄 許可證

本項目遵循MIT 許可證。