Servicenowmcpserver

🚀 MCP Server Configuration Management Database (CMDB) and IT Operations Comprehensive Platform Tool Documentation

The MCP server offers a comprehensive toolset for ServiceNow's Configuration Management Database (CMDB) and IT operations management. This platform encompasses key ITSM functions from incident management, problem management to change management, and provides enhanced CMDB operation capabilities.

🚀 Quick Start

The MCP server provides a comprehensive toolset for ServiceNow's Configuration Management Database (CMDB) and IT operations management. It covers key ITSM functions such as incident management, problem management, and change management, and offers enhanced CMDB operation capabilities.

✨ Features

CMDB Tools

cmdb_sync

• Purpose: Synchronize external data sources with the CMDB.
• Input Parameters:
  • source_type: Data source type (e.g., database or API).
  • target_table: Target table name.
• Example:

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

cmdb_query

• Purpose: Return records that meet the query conditions.
• Input Parameters:
  • query_filter: Query filter (e.g., status=active).
  • limit: Result limit.
• Example:

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

ITSM Tools

itsm_create_incident

• Purpose: Create a new incident record.
• Input Parameters:
  • short_description: Short description (e.g., "Unable to access the internal portal").
  • caller_id: Submitter ID.
  • priority: Priority (e.g., "High" or "Medium").
• Example:

{
    "name": "itsm_create_incident",
    "arguments": {
        "short_description": "Unable to access the internal portal",
        "caller_id": "user123",
        "priority": "High"
    }
}

itsm_close_incident

• Purpose: Close the specified incident record.
• Input Parameters:
  • incident_id: Incident ID.
  • resolution_note: Resolution note.
• Example:

{
    "name": "itsm_close_incident",
    "arguments": {
        "incident_id": "incident12345",
        "resolution_note": "Network connection issue resolved"
    }
}

Enhanced CMDB Functions

cmdb_relationship_mapping

• Purpose: Create or update relationships between Configuration Items (CIs).
• Input Parameters:
  • ci1_id: ID of the first CI.
  • ci2_id: ID of the second CI.
  • relationship_type: Relationship type (e.g., "belongs_to").
• Example:

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

cmdb_bulk_import

• Purpose: Bulk import configuration items.
• Input Parameters:
  • data_file: Path to the data file.
  • mapping_schema: Field mapping scheme.
• Example:

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

Employee Feedback Tools

employee_survey

• Purpose: Publish and collect employee satisfaction surveys.
• Input Parameters:
  • survey_id: Survey ID.
  • department: Department (optional).
• Example:

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

feedback_analytics

• Purpose: Analyze employee feedback data and generate reports.
• Input Parameters:
  • report_type: Report type (e.g., "department" or "overall").
  • time_range: Time range (e.g., "last_month").
• Example:

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

Report Generator

generate_report

• Purpose: Generate reports based on filtering conditions.
• Input Parameters:
  • report_template: Template ID.
  • filter_criteria: Filter criteria (e.g., {status: active}).
• Example:

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

export_data

• Purpose: Export specified data to a file.
• Input Parameters:
  • data_query: Data query string.
  • output_format: Output format (e.g., "CSV" or "JSON").
• Example:

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

Data Statistical Analysis Tools

statistical_analysis

• Purpose: Perform advanced data statistical analysis.
• Input Parameters:
  • analysis_type: Analysis type (e.g., "mean" or "distribution").
  • data_set: Path to the data set.
• Example:

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

predictive_modeling

• Purpose: Create and train predictive models.
• Input Parameters:
  • model_algorithm: Model algorithm (e.g., "linear_regression").
  • training_data: Path to the training data.
• Example:

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

Workflow Manager

workflow_definition

• Purpose: Define and configure workflows.
• Input Parameters:
  • workflow_name: Workflow name.
  • step_definitions: Workflow step definitions.
• Example:

{
    "name": "workflow_definition",
    "arguments": {
        "workflow_name": "Leave Approval Process",
        "step_definitions": [
            { "step_id": "1", "action": "Submit Application" },
            { "step_id": "2", "action": "Department Head Approval" }
        ]
    }
}

workflow_execution

• Purpose: Execute defined workflows.
• Input Parameters:
  • workflow_id: Workflow ID.
  • input_parameters: Input parameters (e.g., { approver: 'manager001' }).
• Example:

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

📚 Documentation

Summary

The MCP server provides powerful tools and functions for ServiceNow, covering multiple aspects such as data management, employee feedback, report generation, and workflow management. Through flexible configuration and expansion, users can efficiently manage and optimize their business processes.