MCP ITSM 集成
针对 IT 服务管理 (ITSM) 工具的模型上下文协议 (MCP) 实现，旨在与 Smithery 配合使用。
概述
该项目为 LLM 提供了一个统一的接口，使其能够使用模型上下文协议 (MCP) 与多个 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell）进行交互。这种集成无需 LLM 学习每个 ITSM 系统的不同 API，而是提供了一套适用于所有系统的标准化工具。
MCP 服务器信息
这是一个符合 MCP 标准的服务器，实现了模型上下文协议 (MCP) 规范。它为大型语言模型提供了一个标准化接口，使其能够通过一套统一的工具与多个 ITSM 系统进行交互。
MCP兼容性
- 协议版本：MCP 1.0
- 工具格式：符合 JSON Schema
- 运行时：Node.js
- 传输：HTTP 和 stdio
- 身份验证：API 密钥
MCP 服务器使用情况
该服务器可直接与任何兼容 MCP 的客户端一起使用，包括：
- MCP Inspector CLI 工具
- 通过 MCP 集成的 Claude
- 任何具有 MCP 支持的 LLM
要在本地检查服务器：
npx @modelcontextprotocol/inspector node index.js
特征
- 统一接口：所有 ITSM 系统中一致的工具定义
- 智能路由：自动将请求路由到适当的 ITSM 系统
- 上下文管理：在交互过程中维护上下文
- 符合 MCP 规范：遵循模型上下文协议规范
- Smithery 集成：旨在与 Smithery 无缝协作
先决条件
- Node.js（v14 或更高版本）
- Smithery 命令行界面
- 访问 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM、Cherwell）
安装
- 克隆存储库：
git clone https://github.com/yourusername/mcp-itsm.git
cd mcp-itsm
- 安装依赖项：
- 配置您的 ITSM 凭据（请参阅配置部分）
- 部署至 Smithery：
配置
ITSM 凭证
使用您的 ITSM 凭据创建一个.env文件：
# ServiceNow
SERVICENOW_INSTANCE=your-instance
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
# Jira
JIRA_URL=https://your-instance.atlassian.net
JIRA_USERNAME=your-username
JIRA_API_TOKEN=your-api-token
# Zendesk
ZENDESK_URL=https://your-instance.zendesk.com
ZENDESK_EMAIL=your-email
ZENDESK_API_TOKEN=your-api-token
# Ivanti Neurons for ITSM
IVANTI_URL=https://your-instance.ivanti.com
IVANTI_CLIENT_ID=your-client-id
IVANTI_CLIENT_SECRET=your-client-secret
IVANTI_TENANT_ID=your-tenant-id
# Cherwell
CHERWELL_URL=https://your-instance.cherwell.com
CHERWELL_CLIENT_ID=your-client-id
CHERWELL_AUTH_MODE=internal
CHERWELL_USERNAME=your-username
CHERWELL_PASSWORD=your-password
Smithery 配置
smithery.yaml文件配置了如何将你的工具部署到 Smithery：
name: mcp-itsm
description: MCP ITSM Tools for ticket management across multiple systems
version: 1.0.0
tools: ./tools.json
command: node index.js
可用工具
此集成提供了以下工具：
- create_ticket ：在任何 ITSM 系统中创建新票据
- get_ticket ：检索票证详细信息
- update_ticket ：更新现有票证
- list_tickets ：列出带有过滤选项的票证
- 分配票证给用户
- add_comment ：向票证添加评论
- search_knowledge_base ：在知识库中搜索相关文章
请参阅tools.json了解完整的工具定义。
用法
一旦部署到 Smithery，LLM 就可以使用这些工具与您的 ITSM 系统进行交互。以下是 LLM 如何创建工单的示例：
User: "I need to report a bug in our accounting software"
LLM: (Makes a tool call)
{
"type": "tool_call",
"data": {
"name": "create_ticket",
"parameters": {
"title": "Bug in accounting software",
"description": "User reported an issue with the accounting software",
"priority": "medium",
"system": "jira"
}
}
}
Response:
{
"type": "tool_response",
"data": {
"name": "create_ticket",
"content": {
"id": "ACCT-123",
"status": "open",
"url": "https://your-instance.atlassian.net/browse/ACCT-123"
}
}
}
调试
该项目包括几个调试工具：
debug_smithery_mcp.bat ：诊断 Smithery 的 MCP 特定问题force_redeploy_smithery.bat ：强制使用 MCP 配置重新部署test_tools.js ：本地测试 MCP 工具调用
文档
图表
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
资源