remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides integration with Atlassian products (beyond Jira) through a unified interface, handling authentication and API interactions.
Enables interaction with Jira instances through a unified API, providing capabilities for accessing issues, managing tickets, and integrating with Jira workflows.
Allows connection to Zendesk instances to manage tickets and support requests through a standardized interface that abstracts away Zendesk-specific API complexities.

Integración ITSM de MCP

Una implementación del Protocolo de Contexto Modelo (MCP) para herramientas de Gestión de Servicios de TI (ITSM), diseñado para funcionar con Smithery.

Descripción general

Este proyecto proporciona una interfaz unificada para que los LLM interactúen con múltiples sistemas ITSM (ServiceNow, Jira, Zendesk, Ivanti Neurons para ITSM y Cherwell) mediante el Protocolo de Contexto de Modelo (MCP). En lugar de que los LLM tengan que aprender diferentes API para cada sistema ITSM, esta integración proporciona un conjunto estandarizado de herramientas que funciona en todos los sistemas.

Información del servidor MCP

Este es un servidor compatible con MCP que implementa la especificación del Protocolo de Contexto de Modelo. Proporciona una interfaz estandarizada para que los Modelos de Lenguaje Grandes interactúen con múltiples sistemas ITSM mediante un conjunto unificado de herramientas.

Compatibilidad MCP

Versión del protocolo : MCP 1.0
Formato de la herramienta : compatible con el esquema JSON
Tiempo de ejecución : Node.js
Transporte : HTTP y stdio
Autenticación : clave API

Uso del servidor MCP

El servidor se puede utilizar directamente con cualquier cliente compatible con MCP, incluidos:

Herramienta CLI de MCP Inspector
Claude a través de la integración de MCP
Cualquier LLM con soporte MCP

Para inspeccionar el servidor localmente:

npx @modelcontextprotocol/inspector node index.js

Características

Interfaz unificada : definiciones de herramientas consistentes en todos los sistemas ITSM
Enrutamiento inteligente : enruta automáticamente las solicitudes al sistema ITSM apropiado
Gestión del contexto : mantiene el contexto en todas las interacciones
Compatible con MCP : sigue la especificación del Protocolo de contexto de modelo
Integración de Smithery : diseñada para funcionar a la perfección con Smithery

Prerrequisitos

Node.js (v14 o superior)
Smithery CLI
Acceso a sistemas ITSM (ServiceNow, Jira, Zendesk, Ivanti Neurons para ITSM, Cherwell)

Instalación

Clonar el repositorio:
git clone https://github.com/yourusername/mcp-itsm.git cd mcp-itsm
Instalar dependencias:
npm install
Configure sus credenciales ITSM (consulte la sección Configuración)
Implementar en Smithery:
smithery deploy

Configuración

Credenciales ITSM

Cree un archivo .env con sus credenciales ITSM:

# ServiceNow
SERVICENOW_INSTANCE=your-instance
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password

# Jira
JIRA_URL=https://your-instance.atlassian.net
JIRA_USERNAME=your-username
JIRA_API_TOKEN=your-api-token

# Zendesk
ZENDESK_URL=https://your-instance.zendesk.com
ZENDESK_EMAIL=your-email
ZENDESK_API_TOKEN=your-api-token

# Ivanti Neurons for ITSM
IVANTI_URL=https://your-instance.ivanti.com
IVANTI_CLIENT_ID=your-client-id
IVANTI_CLIENT_SECRET=your-client-secret
IVANTI_TENANT_ID=your-tenant-id

# Cherwell
CHERWELL_URL=https://your-instance.cherwell.com
CHERWELL_CLIENT_ID=your-client-id
CHERWELL_AUTH_MODE=internal
CHERWELL_USERNAME=your-username
CHERWELL_PASSWORD=your-password

Configuración de herrería

El archivo smithery.yaml configura cómo se implementan sus herramientas en Smithery:

name: mcp-itsm
description: MCP ITSM Tools for ticket management across multiple systems
version: 1.0.0
tools: ./tools.json
command: node index.js

Herramientas disponibles

Esta integración proporciona las siguientes herramientas:

create_ticket : Crea un nuevo ticket en cualquier sistema ITSM
get_ticket : Recuperar detalles del ticket
update_ticket : Actualizar un ticket existente
list_tickets : Lista de tickets con opciones de filtrado
asignar_ticket : Asignar un ticket a un usuario
add_comment : Agregar un comentario a un ticket
search_knowledge_base : Busque artículos relevantes en la base de conocimientos

Consulte tools.json para obtener las definiciones completas de las herramientas.

Uso

Una vez implementadas en Smithery, los LLM pueden usar estas herramientas para interactuar con sus sistemas ITSM. A continuación, se muestra un ejemplo de cómo un LLM podría crear un ticket:

User: "I need to report a bug in our accounting software"

LLM: (Makes a tool call)
{
  "type": "tool_call",
  "data": {
    "name": "create_ticket",
    "parameters": {
      "title": "Bug in accounting software",
      "description": "User reported an issue with the accounting software",
      "priority": "medium",
      "system": "jira"
    }
  }
}

Response:
{
  "type": "tool_response",
  "data": {
    "name": "create_ticket",
    "content": {
      "id": "ACCT-123",
      "status": "open",
      "url": "https://your-instance.atlassian.net/browse/ACCT-123"
    }
  }
}

Depuración

Este proyecto incluye varias herramientas de depuración:

debug_smithery_mcp.bat : diagnostica problemas específicos de MCP con Smithery
force_redeploy_smithery.bat : Fuerza la redistribución con la configuración MCP
test_tools.js : prueba las llamadas a herramientas MCP localmente

Documentación

Integración MCP : Detalles de la implementación del Protocolo de Contexto del Modelo
Referencia rápida de MCP : Guía de referencia rápida para los conceptos de MCP
Referencia de sistemas ITSM : información detallada sobre cada sistema ITSM compatible
Conversión de OpenAI a MCP : Guía para la conversión de llamadas de función de OpenAI a MCP

Diagramas

Arquitectura ITSM de MCP : Arquitectura general de la integración
Fragmentación del sistema : el desafío de la fragmentación del sistema ITSM
Razonamiento de LLM : Cómo los LLM seleccionan el sistema ITSM adecuado
Comparación de beneficios : Comparación del enfoque tradicional frente al enfoque MCP
Integración de Smithery : Cómo se integra MCP con Smithery

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Recursos

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

MCP PARA LA INTEGRACIÓN DE HERRAMIENTAS ITSM

Related Resources

Reddit Discussion about this server

MCP FOR ITSM