MCP FOR ITSM

MCP FOR ITSM

For "MCP FOR ITSM TOOL INTEGRATION", here are a few possible translations, depending on the context: * **MCP 用于 ITSM 工具集成 (MCP yòng yú ITSM gōngjù jíchéng):** This is a direct and general translation. It means "MCP for ITSM tool integration." This is suitable if you're simply stating the purpose of MCP. * **用于 ITSM 工具集成的 MCP (Yòng yú ITSM gōngjù jíchéng de MCP):** This is another way to say the same thing as above, emphasizing the purpose first. It means "MCP used for ITSM tool integration." * **ITSM 工具集成中的 MCP (ITSM gōngjù jíchéng zhōng de MCP):** This translates to "MCP in ITSM tool integration." This is suitable if you're discussing MCP's role within the broader context of ITSM tool integration. * **MCP 与 ITSM 工具的集成 (MCP yǔ ITSM gōngjù de jíchéng):** This translates to "Integration of MCP with ITSM tools." This emphasizes the integration aspect. **Which translation is best depends on the specific context.** To give you the most accurate translation, please provide more information about how this phrase is being used. For example: * Is it a title? * Is it part of a sentence? * What is the overall topic being discussed? **Breakdown of the terms:** * **MCP:** This likely refers to a specific software or component. Without knowing what MCP stands for, I can only translate it as "MCP." * **ITSM:** Information Technology Service Management (信息技术服务管理 - Xìnxī Jìshù Fúwù Guǎnlǐ) * **Tool Integration:** 工具集成 (Gōngjù Jíchéng)

谷歌云集成
AI集成系统
访问服务器

README

MCP ITSM 集成

一个用于 IT 服务管理 (ITSM) 工具的模型上下文协议 (MCP) 实现，旨在与 Smithery 协同工作。

概述

本项目提供了一个统一的接口，供 LLM 使用模型上下文协议 (MCP) 与多个 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM 和 Cherwell）进行交互。无需 LLM 学习每个 ITSM 系统的不同 API，此集成提供了一组可在所有系统中使用的标准化工具。

MCP ITSM 架构

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 CLI
  • 访问 ITSM 系统（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM、Cherwell）

安装

  1. 克隆存储库：

    git clone https://github.com/yourusername/mcp-itsm.git
cd mcp-itsm

  2. 安装依赖项：

    npm install

  3. 配置您的 ITSM 凭据（请参阅配置部分）

  4. 部署到 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 工具
version: 1.0.0
tools: ./tools.json
command: node index.js

可用工具

此集成提供以下工具：

  • create_ticket: 在任何 ITSM 系统中创建新工单
  • get_ticket: 检索工单详细信息
  • update_ticket: 更新现有工单
  • list_tickets: 列出带有过滤选项的工单
  • assign_ticket: 将工单分配给用户
  • add_comment: 向工单添加评论
  • search_knowledge_base: 搜索知识库以查找相关文章

有关完整的工具定义，请参见 tools.json。

用法

部署到 Smithery 后，LLM 可以使用这些工具与您的 ITSM 系统进行交互。以下是 LLM 如何创建工单的示例：

User: "我需要报告我们会计软件中的一个错误"

LLM: (进行工具调用)
{
  "type": "tool_call",
  "data": {
    "name": "create_ticket",
    "parameters": {
      "title": "会计软件中的错误",
      "description": "用户报告了会计软件的问题",
      "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 Request。

许可证

本项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。

资源

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
mcp-server-qdrant

mcp-server-qdrant

这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。

官方
精选
AIO-MCP Server

AIO-MCP Server

🚀 集成了 AI 搜索、RAG 和多服务（GitLab/Jira/Confluence/YouTube）的一体化 MCP 服务器，旨在增强 AI 驱动的开发工作流程。来自 Folk。

精选
本地
https://github.com/Streen9/react-mcp

https://github.com/Streen9/react-mcp

react-mcp 与 Claude Desktop 集成，能够根据用户提示创建和修改 React 应用程序。

精选
本地
MCP Atlassian

MCP Atlassian

适用于 Atlassian Cloud 产品（Confluence 和 Jira）的 Model Context Protocol (MCP) 服务器。此集成专为 Atlassian Cloud 实例设计，不支持 Atlassian Server 或 Data Center 部署。

精选
any-chat-completions-mcp

any-chat-completions-mcp

将 Claude 与任何 OpenAI SDK 兼容的聊天完成 API 集成 - OpenAI、Perplexity、Groq、xAI、PyroPrompts 等。

精选
MySQL MCP Server

MySQL MCP Server

允许人工智能助手通过受控界面列出表格、读取数据和执行 SQL 查询，从而使数据库探索和分析更安全、更有条理。

精选
browser-use MCP server

browser-use MCP server

一个由人工智能驱动的浏览器自动化服务器，它实现了模型上下文协议，从而能够使用自然语言控制网页浏览器，以执行诸如导航、表单填写和视觉交互等任务。

精选
mcp-codex-keeper

mcp-codex-keeper

作为开发知识的守护者，为 AI 助手提供精心策划的最新文档和最佳实践访问权限。

精选