MCP ITSM 集成

针对 IT 服务管理 (ITSM) 工具的模型上下文协议 (MCP) 实现，旨在与 Smithery 配合使用。

概述

该项目为 LLM 提供了一个统一的接口，使其能够使用模型上下文协议 (MCP) 与多个 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell）进行交互。这种集成无需 LLM 学习每个 ITSM 系统的不同 API，而是提供了一套适用于所有系统的标准化工具。

Related MCP server: Salesforce MCP

MCP 服务器信息

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

MCP兼容性

• 协议版本：MCP 1.0

• 工具格式：符合 JSON Schema

• 运行时：Node.js

• 传输：HTTP 和 stdio

• 身份验证：API 密钥

MCP 服务器使用情况

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

• MCP Inspector CLI 工具

• 通过 MCP 集成的 Claude

• 任何具有 MCP 支持的 LLM

要在本地检查服务器：

特征

• 统一接口：所有 ITSM 系统中一致的工具定义

• 智能路由：自动将请求路由到适当的 ITSM 系统

• 上下文管理：在交互过程中维护上下文

• 符合 MCP 规范：遵循模型上下文协议规范

• Smithery 集成：旨在与 Smithery 无缝协作

先决条件

• Node.js（v14 或更高版本）

• Smithery 命令行界面

• 访问 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文件：

Smithery 配置

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

可用工具

此集成提供了以下工具：

• create_ticket ：在任何 ITSM 系统中创建新票据

• get_ticket ：检索票证详细信息

• update_ticket ：更新现有票证

• list_tickets ：列出带有过滤选项的票证

• 分配票证给用户

• add_comment ：向票证添加评论

• search_knowledge_base ：在知识库中搜索相关文章

请参阅tools.json了解完整的工具定义。

用法

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

调试

该项目包括几个调试工具：

• 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 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

资源

• 模型上下文协议

• Smithery 文档

• OpenAI函数调用