remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides integration with Atlassian products (beyond Jira) through a unified interface, handling authentication and API interactions.
Enables interaction with Jira instances through a unified API, providing capabilities for accessing issues, managing tickets, and integrating with Jira workflows.
Allows connection to Zendesk instances to manage tickets and support requests through a standardized interface that abstracts away Zendesk-specific API complexities.

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
安装依赖项：
npm install
配置您的 ITSM 凭据（请参阅配置部分）
部署至 Smithery：
smithery deploy

配置

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 工具调用

文档

MCP 集成：模型上下文协议实现的细节
MCP 快速参考：MCP 概念的快速参考指南
ITSM 系统参考：有关每个受支持的 ITSM 系统的详细信息
OpenAI 到 MCP 的转换：从 OpenAI 函数调用到 MCP 的转换指南

图表

MCP ITSM架构：集成的整体架构
系统碎片化：ITSM系统碎片化的挑战
LLM 推理：LLM 如何选择合适的 ITSM 系统
优势比较：传统方法与 MCP 方法的比较
Smithery 集成：MCP 如何与 Smithery 集成

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

资源

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

用于 ITSM 工具集成的 MCP

Related Resources

Reddit Discussion about this server

MCP FOR ITSM