MCP ITSM 集成

一个用于 IT 服务管理 (ITSM) 工具的模型上下文协议 (MCP) 实现，旨在与 Smithery 协同工作。

概述

本项目提供了一个统一的接口，供 LLM 使用模型上下文协议 (MCP) 与多个 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell）进行交互。无需 LLM 学习每个 ITSM 系统的不同 API，此集成提供了一套可在所有系统中使用的标准化工具。

MCP 服务器信息

这是一个符合 MCP 规范的服务器，实现了模型上下文协议规范。它为大型语言模型提供了一个标准化的接口，通过一套统一的工具与多个 ITSM 系统进行交互。

MCP 兼容性

• 协议版本: MCP 1.0
• 工具格式: 符合 JSON Schema
• 运行时: Node.js
• 传输: HTTP 和 stdio
• 身份验证: API 密钥

MCP 服务器用法

该服务器可以直接与任何兼容 MCP 的客户端一起使用，包括：

• MCP Inspector CLI 工具
• 通过 MCP 集成的 Claude
• 任何支持 MCP 的 LLM

要本地检查服务器：

npx @modelcontextprotocol/inspector node index.js

功能

• 统一接口: 所有 ITSM 系统中一致的工具定义
• 智能路由: 自动将请求路由到适当的 ITSM 系统
• 上下文管理: 维护跨交互的上下文
• 符合 MCP: 遵循模型上下文协议规范
• Smithery 集成: 旨在与 Smithery 无缝协作

前提条件

• Node.js (v14 或更高版本)
• Smithery CLI
• 访问 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM、Cherwell）

安装

1. 克隆存储库：

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

2. 安装依赖项：

   npm install
   

3. 配置您的 ITSM 凭据（请参阅配置部分）

4. 部署到 Smithery：

   smithery deploy
   

配置

ITSM 凭据

创建一个包含您的 ITSM 凭据的 .env 文件：

# 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

Smithery 配置

smithery.yaml 文件配置了如何将您的工具部署到 Smithery：

name: mcp-itsm
description: 用于跨多个系统进行工单管理的 MCP ITSM 工具
version: 1.0.0
tools: ./tools.json
command: node index.js

可用工具

此集成提供以下工具：

• create_ticket: 在任何 ITSM 系统中创建新工单
• get_ticket: 检索工单详细信息
• update_ticket: 更新现有工单
• list_tickets: 列出带有过滤选项的工单
• assign_ticket: 将工单分配给用户
• add_comment: 向工单添加评论
• search_knowledge_base: 搜索知识库以查找相关文章

有关完整的工具定义，请参见 tools.json。

用法

部署到 Smithery 后，LLM 可以使用这些工具与您的 ITSM 系统进行交互。以下是 LLM 如何创建工单的示例：

User: "我需要报告我们会计软件中的一个错误"

LLM: (进行工具调用)
{
  "type": "tool_call",
  "data": {
    "name": "create_ticket",
    "parameters": {
      "title": "会计软件中的错误",
      "description": "用户报告了会计软件的问题",
      "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"
    }
  }
}

调试

本项目包含几个调试工具：

• debug_smithery_mcp.bat: 诊断 Smithery 中与 MCP 相关的特定问题
• force_redeploy_smithery.bat: 强制使用 MCP 配置重新部署
• test_tools.js: 在本地测试 MCP 工具调用

文档

• MCP 集成: 模型上下文协议实现的详细信息
• MCP 快速参考: MCP 概念的快速参考指南
• ITSM 系统参考: 有关每个受支持的 ITSM 系统的详细信息
• OpenAI 到 MCP 转换: 将 OpenAI 函数调用转换为 MCP 的指南

图表

• MCP ITSM 架构: 集成的总体架构
• 系统碎片化: ITSM 系统碎片化的挑战
• LLM 推理: LLM 如何选择适当的 ITSM 系统
• 优势比较: 传统方法与 MCP 方法的比较
• Smithery 集成: MCP 如何与 Smithery 集成

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。

资源

• 模型上下文协议
• Smithery 文档
• OpenAI 函数调用 <a href="https://glama.ai/mcp/servers/hud80wep9g"> <img width="380" height="200" src="https://glama.ai/mcp/servers/hud80wep9g/badge" /> </a>