MCP ITSM 통합
Smithery와 함께 작동하도록 설계된 IT 서비스 관리(ITSM) 도구를 위한 모델 컨텍스트 프로토콜(MCP) 구현입니다.
개요
이 프로젝트는 LLM이 모델 컨텍스트 프로토콜(MCP)을 사용하여 여러 ITSM 시스템(ServiceNow, Jira, Zendesk, Ivanti Neurons for ITSM, Cherwell)과 상호 작용할 수 있는 통합 인터페이스를 제공합니다. LLM이 각 ITSM 시스템마다 다른 API를 학습할 필요 없이, 이 통합을 통해 모든 시스템에서 작동하는 표준화된 도구 세트를 제공합니다.
Related MCP server: MCP-openproject
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 installITSM 자격 증명을 구성하세요(구성 섹션 참조)
대장간에 배치:
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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.