knuckles-team/servicenow-api

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

20 stars 4 forks 质量 86 趋势 30MIT

Repository Install

ServiceNow MCP 服务器和 API 包装器

概览

— API、CLI、MCP 和 A2A 代理接口的安装、部署和使用均由官方文档维护。是一款生产级代理与模型上下文协议（MCP）服务器，设计用于直接与 Python ServiceNow API 包装器接口。 - 通过将方法分组到优化的、可托格格式的工具模块中，最小化令牌开销并消除LLM环境中的工具臃肿。- 完全支持Eunomia策略、OIDC令牌委托和细粒执行上下文跟踪。- 内置支持代理控制协议（ACP）和标准Web接口（AG-UI）的Pydantic AI代理。- 开箱即用的OpenTelemetry导出和原生Langfuse追踪功能。该代理封装了 Python ServiceNow API 包装 API。操作员可以通过程序化或通过其集成的执行入口与其交互。关于如何使用底层 API 包装器、扩展模式绑定和开发者 SDK 引用的详细说明，都在 docs/index.md 中保存。

概述（AI 翻译）

CLI 或 API |MCP |代理

版本：2.4.2

文档 — API、CLI、MCP 的安装、部署和使用，和A2A代理接口在官方文件。

概述

Servicenow Api 是一款生产级代理与模型上下文协议（MCP）服务器，设计用于直接与 Python ServiceNow API 包装器接口。

主要特色

整合动作路由MCP工具： 通过将方法分组到优化的可切换工具模块，最小化令牌开销并消除LLM环境中的工具膨胀。
企业级安全： 完全支持 Eunomia 策略、OIDC 令牌委派及细粒执行上下文跟踪。
集成图代理： 内置的Pydantic AI代理，支持代理控制协议（ACP）和标准Web界面（AG-UI）。
原生遥测与追踪： 开箱即用的OpenTelemetry导出和原生Langfuse追踪。

CLI 或 API

该代理封装了 Python ServiceNow API 包装 API。操作员可以通过程序化或通过其集成的执行入口与其交互。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Servicenow Api

CLI or API | MCP | Agent

Documentation — Installation, deployment, and usage across the API, CLI, MCP, and A2A agent interfaces are maintained in the official documentation.

Overview

Servicenow Api is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with Python ServiceNow API Wrapper.

Key Features

Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
Integrated Graph Agent: Built-in Pydantic AI agent supporting the Agent Control Protocol (ACP) and standard Web interfaces (AG-UI).
Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.

CLI or API

This agent wraps the Python ServiceNow API Wrapper API. The operator can interact with it programmatically or via its integrated execution entrypoints.

Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.

MCP

在 GitHub 查看完整 README

安装

uvx --from servicenow-api[mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "servicenow-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "servicenow-api[mcp]",
        "servicenow-mcp"
      ],
      "env": {
        "MCP_TOOL_MODE": "intent",
        "ACCOUNTTOOL": "True",
        "ACTIVITY_SUBSCRIPTIONSTOOL": "True",
        "AGGREGATETOOL": "True",
        "APPLICATIONTOOL": "True",
        "ATTACHMENTTOOL": "True",
        "AUTHTOOL": "True",
        "BATCHTOOL": "True",
        "CHANGE_MANAGEMENTTOOL": "True",
        "CICDTOOL": "True",
        "CILIFECYCLETOOL": "True",
        "CMDBTOOL": "True",
        "CUSTOM_APITOOL": "True",
        "DATA_CLASSIFICATIONTOOL": "True",
        "DELEGATED_SCOPES": "api",
        "DEVOPSTOOL": "True",
        "EMAILTOOL": "True",
        "FLOWSTOOL": "True",
        "HRTOOL": "True",
        "IMPORT_SETSTOOL": "True",
        "INCIDENTSTOOL": "True",
        "KNOWLEDGE_MANAGEMENTTOOL": "True",
        "METRICBASETOOL": "True",
        "MISCTOOL": "True",
        "OPENAPI_CLIENT_ID": "your_openapi_client_id_here",
        "OPENAPI_CLIENT_SECRET": "your_openapi_client_secret_here",
        "OPENAPI_PASSWORD": "your_openapi_password_here",
        "OPENAPI_USERNAME": "your_openapi_username_here",
        "PLUGINSTOOL": "True",
        "PPMTOOL": "True",
        "PROBLEMTOOL": "True",
        "PRODUCT_INVENTORYTOOL": "True",
        "SDKTOOL": "True",
        "SDK_WORKDIR": "/data/servicenow-sdk-workspace",
        "SERVICENOW_CLIENT_SECRET": "your_servicenow_clie
…