ServiceNow용 모델 완성 프로토콜(MCP) 서버 구현으로, Claude가 ServiceNow 인스턴스와 상호작용할 수 있게 합니다.

개요

이 프로젝트는 Claude가 ServiceNow 인스턴스에 연결하고, 데이터를 검색하며, ServiceNow API를 통해 작업을 수행할 수 있도록 하는 MCP 서버를 구현합니다. 이 서비스는 Claude와 ServiceNow 간의 다리 역할을 하여 원활한 통합을 가능하게 합니다.

특징

• 다양한 인증 방법(Basic, OAuth, API Key)을 사용하여 ServiceNow 인스턴스에 연결함
• Query ServiceNow 레코드 및 테이블
• ServiceNow 레코드 생성, 업데이트 및 삭제
• ServiceNow 스크립트 및 워크플로우 실행
• ServiceNow 서비스 카탈로그 접근 및 조회
• ServiceNow 서비스 카탈로그 분석 및 최적화
• 문제 해결을 위한 디버그 모드
• stdio 및 서버-전송 이벤트(SSE) 통신 지원

설치

전제 조건

• Python 3.11 이상
• 적절한 접근 자격 증명을 가진 ServiceNow 인스턴스

설정

1. 이 저장소를 복제:

2. 가상 환경 생성 및 패키지 설치:

3. ServiceNow 자격 증명으로 .env 파일을 생성합니다:

사용

표준 (stdio) 모드

MCP 서버를 시작하려면:

ServiceNow MCP Server

A Model Completion Protocol (MCP) server implementation for ServiceNow, allowing Claude to interact with ServiceNow instances.

Overview

This project implements an MCP server that enables Claude to connect to ServiceNow instances, retrieve data, and perform actions through the ServiceNow API. It serves as a bridge between Claude and ServiceNow, allowing for seamless integration.

Features

• Connect to ServiceNow instances using various authentication methods (Basic, OAuth, API Key)
• Query ServiceNow records and tables
• Create, update, and delete ServiceNow records
• Execute ServiceNow scripts and workflows
• Access and query the ServiceNow Service Catalog
• Analyze and optimize the ServiceNow Service Catalog
• Debug mode for troubleshooting
• Support for both stdio and Server-Sent Events (SSE) communication

Installation

Prerequisites

• Python 3.11 or higher
• A ServiceNow instance with appropriate access credentials

Setup

1. Clone this repository:

   git clone https://github.com/echelon-ai-labs/servicenow-mcp.git
   cd servicenow-mcp
   

2. Create a virtual environment and install the package:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   pip install -e .
   

3. Create a .env file with your ServiceNow credentials:

   SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
   SERVICENOW_USERNAME=your-username
   SERVICENOW_PASSWORD=your-password
   SERVICENOW_AUTH_TYPE=basic  # or oauth, api_key
   

Usage

Standard (stdio) Mode

To start the MCP server:

python -m servicenow_mcp.cli

Or with environment variables:

SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com SERVICENOW_USERNAME=your-username SERVICENOW_PASSWORD=your-password SERVICENOW_AUTH_TYPE=basic python -m servicenow_mcp.cli

Server-Sent Events (SSE) Mode

The ServiceNow MCP server can also run as a web server using Server-Sent Events (SSE) for communication, which allows for more flexible integration options.

Starting the SSE Server

You can start the SSE server using the provided CLI:

servicenow-mcp-sse --instance-url=https://your-instance.service-now.com --username=your-username --password=your-password

By default, the server will listen on 0.0.0.0:8080. You can customize the host and port:

servicenow-mcp-sse --host=127.0.0.1 --port=8000

Connecting to the SSE Server

The SSE server exposes two main endpoints:

• /sse - The SSE connection endpoint
• /messages/ - The endpoint for sending messages to the server

Example