MCP ITSM 集成

一个用于 IT 服务管理 (ITSM) 工具的 Model Context Protocol (MCP) 实现，专为与 Smithery 配合设计。

概述

该项目提供了一个统一接口，使大型语言模型 (LLM) 能够与多个 ITSM 系统（包括 ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell）交互。无需要求 LLM 学习每个 ITSM 系统的不同 API，此集成提供了一个符合标准的工具集，适用于所有系统。

MCP 服务器信息

这是一个符合 MCP 标准的服务器，实现了 Model Context Protocol 规范。它为大型语言模型提供了标准化接口，以便通过统一的一组工具与多个 ITSM 系统交互。

MCP 兼容性

• 协议版本：MCP 1.0
• 运行时环境：Node.js v14+
• 最低权限要求：管理员访问

操作说明

安装依赖项

在项目目录中，使用以下命令安装所需的包：

npm install express axios dotenv

配置文件

创建一个 .env 文件，并添加以下内容以配置您的环境设置：

PORT=3000
DEBUG=false
DISABLE_IPV6=true

启动服务器

运行以下命令启动 MCP 服务器：

node index.js

功能特性

• 多协议支持：同时支持 REST API 和 gRPC
• 插件架构：可扩展的模块化设计
• 日志记录：详细的请求和响应日志
• 身份验证：内置的身份验证机制

详细文档

MCP 集成细节

参阅 MCP_INTEGRATION.md 获取 MCP 实现的详细信息。

快速参考指南

查阅 MCP_QUICK_REFERENCE.md 获得 MCP 概念的快速入门指南。

支持的 ITSM 系统

获取每个支持的 ITSM 系统的详细信息，请参阅 ITSM_SYSTEMS_REFERENCE.md。

示例用法

创建新问题（Jira）

{
  "type": "function_call",
  "data": {
    "name": "create_issue_jira",
    "arguments": {
      "title": "系统错误报告",
      "description": "无法连接到数据库",
      "priority": "高",
      "assignee": "devops-team"
    }
  }
}

响应示例

{
  "type": "function_response",
  "data": {
    "name": "create_issue_jira",
    "result": {
      "id": "JRA-12345",
      "url": "https://your-instance.atlassian.net/browse/JRA-12345"
    }
  }
}

调试工具

日志分析

使用 debug_smithery_mcp.bat 脚本诊断与 Smithery 的 MCP 连接问题。

强制重新部署

运行 force_redeploy_smithery.bat 脚本以强制应用 MCP 配置并重新部署服务。

图表资源

• MCP ITSM 架构
• 系统碎片化问题
• LLM 选择逻辑
• 方法对比分析
• Smithery 集成方案

贡献指南

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

许可证

本项目根据 MIT 许可证发布，详情参阅 LICENSE 文件。

资源链接

• Model Context Protocol
• Smithery 文档
• OpenAI 函数调用指南