🚀 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或productionPORT: 指定服务器端口（可选）- 相关 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 的指南
图表资源
- MCP ITSM 架构
- 系统碎片化
- LLM 推理
- 好处比较
- Smithery 集成
🔧 技术细节
该项目提供了一个统一接口，解决了大型语言模型与多个 ITSM 系统交互的问题。无需让 LLMs 学习每个 ITSM 系统的不同 API，此集成提供了一套符合标准的工具，适用于所有系统。通过实现 MCP 标准，为大型语言模型提供了标准化接口，使其能通过统一工具与多个 ITSM 系统交互。
📄 许可证
本项目在 MIT 许可证下发布 - 有关详细信息，请参阅 LICENSE 文件。