🚀 MCP ITSM 集成

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

🚀 快速开始

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

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

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 配置环境变量：

   • NODE_ENV: 设置为 development 或 production
   • PORT: 指定服务器端口（可选）
   • 相关 ITSM 系统的 API 凭证

4. 启动服务器：

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 兼容性

工具参考

• 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 的指南

图表资源

• MCP ITSM 架构
• 系统碎片化
• LLM 推理
• 好处比较
• Smithery 集成

🔧 技术细节

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

📄 许可证

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

🔗 相关资源

• 模型上下文协议
• Smithery 文档
• OpenAI 功能调用