JinDaGe - ServiceNowMCPServer MCP Details

article

README

🚀 MCP 服务器配置管理数据库（CMDB）和 IT 运营综合平台工具文档

MCP 服务器为 ServiceNow 打造了一套全面的工具集，用于配置管理数据库（CMDB）和 IT 运营管理。它覆盖了事件管理、问题管理、变更管理等关键 ITSM 功能，还具备增强的 CMDB 操作能力，能助力用户高效管理和优化业务流程。

🚀 快速开始

下面为你详细介绍 MCP 服务器提供的各类工具及其使用方法。

✨ 主要特性

提供了用于 CMDB 同步、查询的工具。
支持 ITSM 事件的创建与关闭操作。
具备增强的 CMDB 功能，如关系映射和批量导入。
有员工反馈工具，可进行调查和分析。
包含报告生成器和数据统计分析工具。
提供工作流管理器，可定义和执行工作流。

📦 安装指南

文档中未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

CMDB 工具

cmdb_sync

目的：同步外部数据源与 CMDB
输入参数：
- source_type：数据源类型（如数据库或 API）
- target_table：目标表名

{
    "name": "cmdb_sync",
    "arguments": {
        "source_type": "database",
        "target_table": "inventory"
    }
}

cmdb_query

目的：根据查询条件返回符合条件的记录
输入参数：
- query_filter：查询过滤器（如 status=active）
- limit：结果限制数

{
    "name": "cmdb_query",
    "arguments": {
        "query_filter": "status=active",
        "limit": 100
    }
}

ITSM 工具

itsm_create_incident

目的：创建新的事件记录
输入参数：
- short_description：简短描述（如“无法访问内部门户”）
- caller_id：提交人 ID
- priority：优先级（如“高”或“中”）

{
    "name": "itsm_create_incident",
    "arguments": {
        "short_description": "无法访问内部门户",
        "caller_id": "user123",
        "priority": "High"
    }
}

itsm_close_incident

目的：关闭指定的事件记录
输入参数：
- incident_id：事件 ID
- resolution_note：解决说明

{
    "name": "itsm_close_incident",
    "arguments": {
        "incident_id": "incident12345",
        "resolution_note": "已解决网络连接问题"
    }
}

增强 CMDB 功能

cmdb_relationship_mapping

目的：创建或更新配置项（CI）之间的关系
输入参数：
- ci1_id：第一个 CI 的 ID
- ci2_id：第二个 CI 的 ID
- relationship_type：关系类型（如“属于”）

{
    "name": "cmdb_relationship_mapping",
    "arguments": {
        "ci1_id": "server001",
        "ci2_id": "network001",
        "relationship_type": "belongs_to"
    }
}

cmdb_bulk_import

目的：批量导入配置项
输入参数：
- data_file：数据文件路径
- mapping_schema：字段映射方案

{
    "name": "cmdb_bulk_import",
    "arguments": {
        "data_file": "/path/to/data.csv",
        "mapping_schema": "schema.json"
    }
}

员工反馈工具

employee_survey

目的：发布并收集员工满意度调查
输入参数：
- survey_id：调查 ID
- department：部门（可选）

{
    "name": "employee_survey",
    "arguments": {
        "survey_id": "Q1-Survey001",
        "department": "IT"
    }
}

feedback_analytics

目的：分析员工反馈数据并生成报告
输入参数：
- report_type：报告类型（如“部门”或“整体”）
- time_range：时间范围（如“过去一个月”）

{
    "name": "feedback_analytics",
    "arguments": {
        "report_type": "department",
        "time_range": "last_month"
    }
}

报告生成器

generate_report

目的：根据过滤条件生成报告
输入参数：
- report_template：模板 ID
- filter_criteria：过滤标准（如 {status: active}）

{
    "name": "generate_report",
    "arguments": {
        "report_template": "template001",
        "filter_criteria": "{status: active}"
    }
}

export_data

目的：导出指定数据到文件
输入参数：
- data_query：数据查询字符串
- output_format：输出格式（如“CSV”或“JSON”）

{
    "name": "export_data",
    "arguments": {
        "data_query": "SELECT * FROM users WHERE department = 'IT'",
        "output_format": "CSV"
    }
}

数据统计分析工具

statistical_analysis

目的：执行高级数据统计和分析
输入参数：
- analysis_type：分析类型（如“平均值”或“分布”）
- data_set：数据集路径

{
    "name": "statistical_analysis",
    "arguments": {
        "analysis_type": "mean",
        "data_set": "/path/to/data.csv"
    }
}

predictive_modeling

目的：创建并训练预测模型
输入参数：
- model_algorithm：模型算法（如“线性回归”）
- training_data：训练数据路径

{
    "name": "predictive_modeling",
    "arguments": {
        "model_algorithm": "linear_regression",
        "training_data": "/path/to/train.csv"
    }
}

工作流管理器

workflow_definition

目的：定义和配置工作流
输入参数：
- workflow_name：工作流名称
- step_definitions：流程步骤定义

{
    "name": "workflow_definition",
    "arguments": {
        "workflow_name": "请假审批流程",
        "step_definitions": [
            { "step_id": "1", "action": "提交申请" },
            { "step_id": "2", "action": "部门主管审批" }
        ]
    }
}

workflow_execution

目的：执行定义好的工作流
输入参数：
- workflow_id：工作流 ID
- input_parameters：输入参数（如 { approver: 'manager001' }）

{
    "name": "workflow_execution",
    "arguments": {
        "workflow_id": "WF001",
        "input_parameters": { "approver": "manager001" }
    }
}

高级用法

文档中未提及高级用法相关内容，故暂不展示。

📚 详细文档

文档中未提及更多详细说明内容，故跳过此章节。

🔧 技术细节

文档中未提及技术实现细节相关内容，故跳过此章节。

📄 许可证

文档中未提及许可证信息，故跳过此章节。

总结

MCP 服务器为 ServiceNow 提供了强大的工具和功能，涵盖数据管理、员工反馈、报告生成以及工作流管理等多个方面。通过灵活的配置和扩展，用户能够高效地管理和优化其业务流程。

ServiceNowMCPServer