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:

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

1. Clonar el repositorio:

   git clone https://github.com/yourusername/mcp-itsm.git cd mcp-itsm

2. Instalar dependencias:

   npm install

3. Configure sus credenciales ITSM (consulte la sección Configuración)

4. Implementar en Smithery:

   smithery deploy

Configuración

Credenciales ITSM

Cree un archivo .env con sus credenciales ITSM:

Configuración de herrería

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

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:

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

• Protocolo de contexto modelo

• Documentación de herrería

• Llamada de función de OpenAI