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 통합

Smithery와 함께 작동하도록 설계된 IT 서비스 관리(ITSM) 도구를 위한 모델 컨텍스트 프로토콜(MCP) 구현입니다.

개요

이 프로젝트는 LLM이 모델 컨텍스트 프로토콜(MCP)을 사용하여 여러 ITSM 시스템(ServiceNow, Jira, Zendesk, Ivanti Neurons for ITSM, Cherwell)과 상호 작용할 수 있는 통합 인터페이스를 제공합니다. LLM이 각 ITSM 시스템마다 다른 API를 학습할 필요 없이, 이 통합을 통해 모든 시스템에서 작동하는 표준화된 도구 세트를 제공합니다.

MCP 서버 정보

이는 모델 컨텍스트 프로토콜(MCP) 사양을 구현하는 MCP 호환 서버입니다. 대규모 언어 모델(LLM)이 통합 도구 세트를 통해 여러 ITSM 시스템과 상호 작용할 수 있도록 표준화된 인터페이스를 제공합니다.

MCP 호환성

프로토콜 버전 : MCP 1.0
도구 형식 : JSON 스키마 호환
런타임 : Node.js
전송 : HTTP 및 stdio
인증 : API 키

MCP 서버 사용

이 서버는 다음을 포함한 모든 MCP 호환 클라이언트와 함께 직접 사용할 수 있습니다.

MCP Inspector CLI 도구
MCP 통합을 통한 Claude
MCP 지원이 있는 모든 LLM

서버를 로컬로 검사하려면:

지엑스피1

특징

통합 인터페이스 : 모든 ITSM 시스템에서 일관된 도구 정의
지능형 라우팅 : 요청을 적절한 ITSM 시스템으로 자동 라우팅합니다.
컨텍스트 관리 : 상호 작용 전반에 걸쳐 컨텍스트를 유지합니다.
MCP 준수 : 모델 컨텍스트 프로토콜 사양을 따릅니다.
Smithery 통합 : Smithery와 원활하게 작동하도록 설계되었습니다.

필수 조건

Node.js(v14 이상)
스미서리 CLI
ITSM 시스템(ServiceNow, Jira, Zendesk, ITSM용 Ivanti Neurons, Cherwell)에 대한 액세스

설치

저장소를 복제합니다.
git clone https://github.com/yourusername/mcp-itsm.git cd mcp-itsm
종속성 설치:
npm install
ITSM 자격 증명을 구성하세요(구성 섹션 참조)
대장간에 배치:
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.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 : 필터링 옵션을 사용하여 티켓 목록 표시
assign_ticket : 사용자에게 티켓을 할당합니다.
add_comment : 티켓에 댓글을 추가합니다
search_knowledge_base : 지식베이스에서 관련 문서를 검색합니다.

전체 도구 정의는 tools.json 참조하세요.

용법

LLM은 Smithery에 배치되면 이러한 도구를 사용하여 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와 통합되는 방식

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

자원

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