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.
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:
- Configure sus credenciales ITSM (consulte la sección Configuración)
- Implementar en Smithery:
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 Smitheryforce_redeploy_smithery.bat : Fuerza la redistribución con la configuración MCPtest_tools.js : prueba las llamadas a herramientas MCP localmente
Documentación
Diagramas
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