Реализация сервера Model Completion Protocol (MCP) для ServiceNow, позволяющая Claude взаимодействовать с экземплярами ServiceNow.

Обзор

Этот проект реализует MCP-сервер, который позволяет Claude подключаться к экземплярам ServiceNow, получать данные и выполнять действия через API ServiceNow. Он служит мостом между Claude и ServiceNow, обеспечивая бесшовную интеграцию.

Особенности

• Подключение к экземплярам ServiceNow с использованием различных методов аутентификации (Basic, OAuth, API Key)
• Записи и таблицы Query ServiceNow
• Создавать, обновлять и удалять записи ServiceNow
• Выполнить скрипты и рабочие процессы ServiceNow
• Доступ и запрос к каталогу сервисов ServiceNow
• Анализ и оптимизация каталога сервисов ServiceNow
• Режим отладки для устранения неполадок
• Поддержка связи как stdio, так и Server-Sent Events (SSE)

Установка

Требования

• Python 3.11 или выше
• Экземпляр ServiceNow с соответствующими учётными данными доступа

Подготовка

1. Клонируйте этот репозиторий:

2. Создайте виртуальную среду и установите пакет:

3. Создайте файл .env с учётными данными ServiceNow:

Использование

Стандартный (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