金大哥 - itsm-integration-platform MCP 详情

article

README

🚀 MCP ITSM 集成

本项目是一个用于 IT 服务管理 (ITSM) 工具的 Model Context Protocol (MCP) 实现，专为与 Smithery 配合设计。它提供统一接口，让大型语言模型 (LLM) 能与多个 ITSM 系统交互，无需学习各系统不同 API。

🚀 快速开始

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

MCP ITSM 架构

✨ 主要特性

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

📦 安装指南

安装依赖项

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

npm install express axios dotenv

配置文件

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

PORT=3000
DEBUG=false
DISABLE_IPV6=true

启动服务器

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

node index.js

💻 使用示例

基础用法

创建新问题（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"
    }
  }
}

📚 详细文档

MCP 集成细节

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

快速参考指南

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

支持的 ITSM 系统

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

🔧 技术细节

MCP 服务器信息

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

MCP 兼容性

| 属性 | 详情 | |------|------| | 协议版本 | MCP 1.0 | | 运行时环境 | Node.js v14+ | | 最低权限要求 | 管理员访问 |

🛠️ 调试工具

日志分析

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

强制重新部署

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

itsm-integration-platform