Servicenow

🚀 ServiceNow MCP 服務器

一個與 ServiceNow 對接的模型上下文協議 (MCP) 服務器，允許 AI 代理通過安全的 API 訪問和操作 ServiceNow 數據。使用該服務器，可通過自然語言與 ServiceNow 進行交互，讓搜索記錄、更新數據和管理腳本變得更加簡便。

🚀 快速開始

你可以通過以下方式啟動 ServiceNow MCP 服務器：

命令行運行

使用 Python 模塊啟動服務器：

python -m mcp_server_servicenow.cli --url "https://your-instance.service-now.com/" --username admin --password admin

配置文件

創建一個配置文件 config.json，內容如下：

{
    "instance_url": "https://your-instance.service-now.com/",
    "username": "admin",
    "password": "admin"
}

然後運行：

python -m mcp_server_servicenow.cli --config config.json

✨ 主要特性

資源

• servicenow://incidents：列出最近的故障單
• servicenow://incidents/{number}：通過編號獲取特定故障單
• servicenow://users：列出用戶信息
• servicenow://knowledge：列出知識庫文章
• servicenow://tables：展示可用表格
• servicenow://tables/{table}：從指定表格獲取記錄
• servicenow://schema/{table}：獲取表格的模式信息

工具

基礎工具

• create_incident：創建新的故障單
• update_incident：更新現有故障單
• search_records：使用文本查詢搜索記錄
• get_record：通過 sys_id 獲取特定記錄
• perform_query：執行 ServiceNow 查詢
• add_comment：添加客戶可見的評論（僅顯示給客戶）
• add_work_notes：添加內部工作筆記

自然語言工具

• natural_language_search：使用自然語言搜索記錄（例如：查找所有關於郵件的故障單）
• natural_language_update：使用自然語言更新記錄（例如：將故障單 INC0010001 更新為“正在處理中”）
• update_script：更新 ServiceNow 腳本文件（腳本包含、業務規則等）

📦 安裝指南

從 PyPI 安裝

pip install mcp-server-servicenow

從源碼安裝

git clone https://github.com/michaelbuckner/servicenow-mcp.git
cd servicenow-mcp
pip install -e .

📚 詳細文檔

開發

安裝開發依賴

pip install -e ".[dev]"

運行測試

pytest

貢獻

歡迎貢獻！請隨意提交 Pull Request。

1. 叉取倉庫
2. 創建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 提交 Pull Request

📄 許可證

本項目採用 MIT License 許可證，具體內容請參見 LICENSE 文件。