ServiceNow向けのモデル完了プロトコル(MCP)サーバー実装で、ClaudeがServiceNowのインスタンスとやり取りできるようにします。

概要

このプロジェクトは、ClaudeがServiceNowインスタンスに接続し、データを取得し、ServiceNow APIを通じて操作を行うことを可能にするMCPサーバーを実装しています。これはClaudeとServiceNowの間の橋渡しとして機能し、シームレスな統合を可能にします。

特徴

• さまざまな認証方法(Basic、OAuth、APIキー)を使ってServiceNowインスタンスに接続
• Query ServiceNowレコードおよびテーブル
• ServiceNowレコードの作成、更新、削除
• ServiceNowスクリプトとワークフローを実行する
• ServiceNowサービスカタログへのアクセスおよび検索
• ServiceNowサービスカタログの分析と最適化
• トラブルシューティングのためのデバッグモード
• stdioおよびServer-Sent Events(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