Itsm Integration Platform

🚀 MCP ITSM Integration

An implementation of the Model Context Protocol (MCP) for IT Service Management (ITSM) tools, specifically designed to work with Smithery.

🚀 Quick Start

This project offers a unified interface that enables Large Language Models (LLMs) to interact with multiple ITSM systems, including ServiceNow, Jira, Zendesk, Ivanti Neurons for ITSM, and Cherwell. Instead of requiring the LLM to learn the different APIs of each ITSM system, this integration provides a standards-compliant toolset applicable to all systems.

✨ Features

MCP Server Information

This is an MCP-compliant server that implements the Model Context Protocol specification. It provides a standardized interface for large language models to interact with multiple ITSM systems through a unified set of tools.

MCP Compatibility

Functional Features

• Multi-protocol Support: Supports both REST API and gRPC simultaneously.
• Plugin Architecture: An extensible modular design.
• Logging: Detailed request and response logs.
• Authentication: Built-in authentication mechanism.

📦 Installation

Install Dependencies

In the project directory, use the following command to install the required packages:

npm install express axios dotenv

Configuration File

Create a .env file and add the following content to configure your environment settings:

PORT=3000
DEBUG=false
DISABLE_IPV6=true

Start the Server

Run the following command to start the MCP server:

node index.js

💻 Usage Examples

Basic Usage

Create a New Issue (Jira)

{
  "type": "function_call",
  "data": {
    "name": "create_issue_jira",
    "arguments": {
      "title": "System Error Report",
      "description": "Unable to connect to the database",
      "priority": "High",
      "assignee": "devops-team"
    }
  }
}

Advanced Usage

Response Example

{
  "type": "function_response",
  "data": {
    "name": "create_issue_jira",
    "result": {
      "id": "JRA-12345",
      "url": "https://your-instance.atlassian.net/browse/JRA-12345"
    }
  }
}

📚 Documentation

MCP Integration Details

Refer to MCP_INTEGRATION.md for detailed information on the MCP implementation.

Quick Reference Guide

Consult MCP_QUICK_REFERENCE.md for a quick-start guide to MCP concepts.

Supported ITSM Systems

For detailed information on each supported ITSM system, refer to ITSM_SYSTEMS_REFERENCE.md.

Debugging Tools

Log Analysis

Use the debug_smithery_mcp.bat script to diagnose MCP connection issues with Smithery.

Force Redeployment

Run the force_redeploy_smithery.bat script to force the application of MCP configuration and redeploy the service.

Diagram Resources

• MCP ITSM Architecture
• System Fragmentation Issue
• LLM Selection Logic
• Method Comparison Analysis
• Smithery Integration Solution

Contribution Guidelines

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.

Resource Links

• Model Context Protocol
• Smithery Documentation
• OpenAI Function Calling Guide