🚀 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，此集成提供了一个符合标准的工具集，适用于所有系统。
✨ 主要特性
- 多协议支持：同时支持 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 配置并重新部署服务。
📊 图表资源
- MCP ITSM 架构
- 系统碎片化问题
- LLM 选择逻辑
- 方法对比分析
- Smithery 集成方案
🤝 贡献指南
欢迎贡献！请随意提交 Pull Request。
📄 许可证
本项目根据 MIT 许可证发布，详情参阅 LICENSE 文件。