ServiceNow 的模型完备协议（MCP）服务器实现，允许 Claude 与 ServiceNow 实例交互。

概述

该项目实现了一个MCP服务器，使Claude能够连接ServiceNow实例、检索数据并通过ServiceNow API执行操作。它作为Claude与ServiceNow之间的桥梁，实现无缝集成。

特色

• 通过多种认证方法（Basic、OAuth、API Key）连接 ServiceNow 实例
• 查询ServiceNow记录和表
• 创建、更新和删除ServiceNow记录
• 执行ServiceNow脚本和工作流
• 访问和查询ServiceNow服务目录
• 分析和优化ServiceNow服务目录
• 调试模式用于故障排除
• 支持stdio和服务器发送事件（SSE）通信

安装

先决条件

• Python 3.11 或更高版本
• 一个具有适当访问凭据的ServiceNow实例

布置

1. 克隆此仓库：

2. 创建一个虚拟环境并安装该软件包：

3. 创建一个包含 ServiceNow 凭证的 .env 文件：

用途

标准（标准）模式

启动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