JinDaGe - ITSM Integration MCP Details

article

README

🚀 MCP ITSM 集成

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

🚀 快速开始

在开始使用本项目之前，请确保您已满足以下先决条件：

Node.js 和 npm 已安装
Smithery 已安装并配置
具备相关 ITSM 系统的 API 访问权限

安装步骤

克隆仓库：

git clone https://github.com/your-repository.git

安装依赖项：

npm install

配置环境变量：
- NODE_ENV: 设置为 development 或 production
- PORT: 指定服务器端口（可选）
- 相关 ITSM 系统的 API 凭证
启动服务器：

npm start

配置

创建一个 .env 文件并添加以下内容：

NODE_ENV=development
PORT=3000
SERVICE_NAME=jira
API_KEY=your_api_key_here

✨ 主要特性

多系统支持：支持多个 ITSM 系统，包括 ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell。
统一接口：提供统一的 MCP 接口，使大型语言模型能通过一套标准工具与多个 ITSM 系统交互。
本地调试：提供本地调试工具，方便开发和测试。
丰富文档：提供详细的文档和参考资料，便于用户使用和开发。

📦 安装指南

克隆仓库

git clone https://github.com/your-repository.git

安装依赖

npm install

配置环境变量

配置环境变量时，需要设置 NODE_ENV、PORT 以及相关 ITSM 系统的 API 凭证。

启动服务器

npm start

💻 使用示例

基础用法

以下是一个创建 Jira 任务的示例：

{
  "type": "tool_call",
  "data": {
    "name": "create_jira_task",
    "parameters": {
      "title": "New Task",
      "description": "Please complete this task as soon as possible.",
      "priority": "high"
    }
  }
}

响应示例：

{
  "type": "tool_response",
  "data": {
    "name": "create_jira_task",
    "content": {
      "id": "TASK-123",
      "status": "open",
      "url": "https://your-instance.atlassian.net/browse/TASK-123"
    }
  }
}

📚 详细文档

MCP 服务器信息

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

MCP 兼容性

| 属性 | 详情 | |------|------| | 协议版本 | MCP 1.0 | | 工具格式 | JSON Schema 符合 | | 运行时 | Node.js | | 传输方式 | HTTP 和 stdio | | 身份验证 | API 密钥 |

工具参考

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

文档资源

MCP 集成: MCP 实现的详细信息
MCP 快速参考: MCP 概念的快速指南
ITSM 系统参考: 支持的每个 ITSM 系统的详细信息
OpenAI 到 MCP 转换: 从 OpenAI 功能调用转换到 MCP 的指南

图表资源

🔧 技术细节

该项目提供了一个统一接口，解决了大型语言模型与多个 ITSM 系统交互的问题。无需让 LLMs 学习每个 ITSM 系统的不同 API，此集成提供了一套符合标准的工具，适用于所有系统。通过实现 MCP 标准，为大型语言模型提供了标准化接口，使其能通过统一工具与多个 ITSM 系统交互。

📄 许可证

本项目在 MIT 许可证下发布 - 有关详细信息，请参阅 LICENSE 文件。

ITSM Integration