Token导航 LogoToken导航TokenDH.com
nowaikit (Aartiq) logo
开发工具stdio官方级别未说明来源级核验

nowaikit (Aartiq)

MCP Server

nowaikit

NowAIKit是一个全面的ServiceNow AI工具包,提供400多种工具,支持多种AI平台,实现自动化操作和多实例管理。

工具数

0

提示词数

0

GitHub Stars

9

资源数

0
TypeScriptClaude开发工具Claude DesktopClaudeCursorWindsurfClineVS Code

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

aartiq

提供方

aartiq

最后核验

2026/5/17 20:19

运行时

Node.js

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

npx nowaikit setup

详细介绍

![AI-Powered](https://github.com/aartiq/nowaikit) ![Tools](docs/TOOLS.md) ![TypeScript](https://www.typescriptlang.org/) ![License: Source Available](LICENSE) ![ServiceNow](https://developer.servicenow.com) ![MCP](https://modelcontextprotocol.io) ](https://nodejs.org)

现在AIKit

最全面的ServiceNow人工智能工具包

400+工具·31+ServiceNow模块·5分钟设置·免费使用·适用于任何AI

现在AIKit 是ServiceNow最全面、最适合生产的人工智能工具包,也是唯一一个真正做到这一切的工具包。

连接 克劳德, ChatGPT, 双子座, 光标, GitHub Copilot,或任何兼容MCP的AI在5分钟内。然后让你的AI在每个ServiceNow模块中读取、构建、部署和自动化——事件、更改、脚本、流、门户、集成、HRSD、CSM等等。

用简单的英语问。从聊天中部署业务规则。按需运行ATF套件。同时查询dev、staging和prod。跨多个客户租户实现自动化,无需切换选项卡。 你的AI,你的实例,你的规则。

任何AI,任何实例。任何规模。免费使用。

关键词: ServiceNow MCP服务器·模型上下文协议·ServiceNow AI·ITSM自动化·ServiceNow Claude·ServiceNow ChatGPT·ServiceNow Cursor·ServiceNow Copilot·ServiceNow LLM·ServiceNow代理·MCP工具·ServiceNow API·代理AI·ServiceNow开发工具
初学者需要零ServiceNow API知识。5分钟后连接。用简单的英语问。免费PDI请访问developer.servicenow.com
开发者以AI速度编写、部署、测试和管理脚本、流、小部件和集成,速度提高了10倍。
建筑师和MSP协调多步骤的自主工作流程。比较环境。在一个会话中管理多个客户租户。

______________________________________________________________________

这是给谁的?

初学者

需要零ServiceNow API知识。

在5分钟内将Claude Desktop或Cursor连接到您的免费PDI。用简单的英语提问、浏览事件、搜索知识库文章、下目录订单、监控SLA——所有这些都可以在您的AI聊天窗口中完成。没有代码。没有邮递员。没有文件潜水。问吧。

*从这里开始→ 5分钟快速入门*

开发者

将AI作为您的开发合作伙伴,速度提高10倍。

编写业务规则、部署客户端脚本、管理UI策略和ACL、创建服务门户小部件、配置REST消息、管理转换映射和更新变更集——所有这些都是用简单的英语编写的。内置完整的TypeScript类型、ATF集成和基于角色的包。

*探索→ 平台开发包*

建筑师、管理员和MSP

自主工作流程。多实例。多客户。

触发代理剧本,编排多步骤ITSM/HRSD/CSM流程,并排比较环境,在一个会话中管理数十个客户租户,并在整个ServiceNow资产中以AI速度运行完整的数据质量审计。

*深潜→ 现在协助和代理指南*

______________________________________________________________________

为什么现在AIKit

完全自主的人工智能操作

你的AI不只是回答问题——它 *行为*.创建事件、编写和部署脚本、触发流、触发事件、上传附件、管理变更集和运行完整的ATF套件——端到端,无需手动步骤。Native Now Assist Agent Playbook支持下一代ServiceNow AI自动化。

与所有AI协同工作,开箱即用

Claude、ChatGPT、Gemini、Grok、Cursor、Windsurf、GitHub Copilot、Amazon Q、JetBrains、Continue.dev、Cline、Zed、Google AI Studio、Ollama --所有这些都是开箱即用的。任何兼容MCP的客户端。任何自定义Python或TypeScript代理。一个工具包,每个AI平台,零锁定。

无与伦比的平台覆盖范围

400+生产就绪工具 跨每个ServiceNow域——ITSM、ITOM、HRSD、CSM、SecOps、GRC、敏捷、ATF、流设计器、脚本、Now Assist、服务门户、集成中心、性能分析、系统属性、更新集、虚拟代理、ITAM、DevOps、机器学习、工作区/UIB、移动和部署。没有什么比这更接近了。

基于角色的工具智能

14个预构建的角色包——服务台、平台开发人员、门户开发人员、集成工程师、ITOM工程师、AI开发人员、ITAM分析师、DevOps工程师等等。每个都为该角色提供了正确的工具。减少噪音,强制最低权限,每个团队配置一次。

默认安全,需要时功能强大

五层权限模型可以保护您的实例。 阅读始终处于打开状态。 写、CMDB、脚本、Now Assist和ATF功能都需要一个明确的选择加入标志。没有人工智能可以意外修改您的生产数据。随着信心的增长而扩展权限,而无需接触代码。

真正的多实例和多客户

连接到 无限ServiceNow实例 从一个会话开始——开发、暂存、生产, *和* 同时拥有多个客户租户。通过 instance: "acme_prod" 在任何工具调用中,或 switch_instance 全球地。MSP、顾问和企业团队可以同时在每个环境中进行比较、查询和自动化。没有其他ServiceNow AI工具包能做到这一点。

______________________________________________________________________

快速链接

资源链接
所有工具参考docs/TOOLS.md
客户端设置(所有AI工具,初级+高级)docs/CLIENT_SETUP.md
基于角色的工具包
现在辅助和人工智能集成docs/NOW_ASSIST.md
ATF测试指南docs/ATF.md
脚本管理docs/SCRIPTING.md
报告和分析文档/报告.md
多实例设置docs/MULTI_INSTANCE.md
120+真实世界示例示例.md
变更日志更改日志.md

______________________________________________________________________

模块覆盖范围

涵盖完整ServiceNow平台的域模块:

模块关键能力
核心和CMDB记录查询、架构发现、CMDB CI、ITOM发现、MID服务器、多实例管理
事件管理创建、更新、解决、关闭、工作笔记、评论
问题管理问题记录、根本原因分析、已知错误
变更管理创建、获取、更新、提交审批、关闭变更请求
任务管理通用任务、我的任务列表、完成情况
知识库搜索、创建、更新、发布知识库文章
服务目录和审批目录浏览、创建/更新项目、订单项目、SLA跟踪、审批工作流、审批规则
用户和组管理用户、组、成员资格、角色分配
报告和分析聚合查询、趋势分析、创建/更新报告、计划作业CRUD、运行历史记录
ATF测试测试套件、测试执行、ATF故障洞察
Now Assist/AINLQ、AI搜索、摘要、解决方案建议、代理剧本
脚本业务规则、脚本包括、客户端脚本CRUD、UI策略、UI操作、ACL管理、变更集
敏捷/Scrum故事、史诗、冲刺、Scrum任务
人力资源服务交付(HRSD)人力资源案例、人力资源服务、员工档案、入职/离职
客户服务管理(CSM)客户案例、账户、联系人、产品、SLA
安全运营和GRC安全运营事件、漏洞、GRC风险、控制、威胁情报
流程设计器和流程自动化流程、子流程、触发器、执行、流程自动化剧本
服务门户和UI生成器创建/列出门户和页面、小部件(创建/更新/部署)、Next Experience应用程序/页面、主题
集成中心REST消息、转换映射、导入集、事件注册表、OAuth应用程序、凭据别名
通知和附件电子邮件通知、电子邮件日志、文件附件(上传/列表/删除)、模板、订阅
性能分析PA指标/记分卡、时间序列、创建/更新仪表板、PA作业、数据质量检查
系统属性获取、设置、批量操作、验证、导出/导入、审核历史记录
更新集管理创建、切换、预览、完成、导出、自动确保活动集
虚拟代理(VA)主题创作、对话历史、类别、主题列表
IT资产管理(ITAM)资产、软件许可证、合同、合规性报告
DevOps和管道跟踪管道、部署、变更治理、DORA指标
范围应用程序(App Studio)列出、获取、创建和更新范围应用程序记录

______________________________________________________________________

认证

支持两种身份验证方法:

方法最适合
基本认证开发、个人实例、快速设置
OAuth 2.0 (客户端凭据/密码授予)生产部署、服务帐户

SSO/OIDC身份验证(Okta、Azure AD/Entra、Ping Identity)在企业版中可用——请参阅 nowaikit.com/#定价.

有关ServiceNow中的OAuth设置,请参阅 docs/SERVICENOW_OAUTH_SETUP.md.

______________________________________________________________________

权限系统

默认情况下,四层权限模型可以保护您的实例安全:

层级环境变量覆盖范围
0--读取*(始终打开)*所有查询和读取操作
1--写WRITE_ENABLED=true跨ITSM、HRSD、CSM、敏捷创建/更新
2-CMDB写入CMDB_WRITE_ENABLED=true在CMDB中创建/更新CI
3--脚本编写SCRIPTING_ENABLED=true业务规则、脚本、变更集
4--现在协助NOW_ASSIST_ENABLED=trueAI代理剧本、NLQ、AI搜索

______________________________________________________________________

基于角色的工具包

MCP_TOOL_PACKAGE 仅公开与每个角色相关的工具:

套装人物角色附带工具
full管理员所有工具(400+)
service_deskL1/L2代理事件、任务、批准、知识库、SLA
change_coordinator变更经理变更(创建/批准/关闭)、CAB、CMDB、批准
knowledge_author知识库作者知识库创建/发布
catalog_builder目录管理员目录、用户、组
system_administrator系统管理员用户、组、报告、日志、通知、附件、ACL、PA
platform_developer开发人员脚本、UI策略、UI操作、ACL、客户端脚本、ATF、变更集
portal_developer门户/UX开发门户、页面、小部件(创建/更新)、UI策略、UI操作、客户端脚本
integration_engineer集成开发REST消息、转换映射、导入集、事件、OAuth、凭据
itom_engineerITOM工程师CMDB、发现、MID服务器、事件
agile_managerScrum大师故事、史诗、冲刺
ai_developerAI建设者现在辅助,NLQ,代理剧本

______________________________________________________________________

入门指南

选项A--交互式安装向导(推荐)

# Install globally (Node.js 20+ required)
npm install -g nowaikit

# Run the wizard — detects your AI clients and writes config automatically
npx nowaikit setup

向导将:

  1. 请求您的ServiceNow实例URL+凭据
  2. 测试连接
  3. 允许您选择工具包和权限级别
  4. 在您的计算机上检测克劳德桌面、光标、VS代码、Windsurf、Continue.dev、克劳德代码
  5. 直接编写配置——无需复制粘贴,无需手动编辑JSON
# Add a second instance later
nowaikit setup --add

# Manage instances
nowaikit instances list

选项B--Web仪表板(一个命令)

npx nowaikit web

打开NowAIKit仪表板 http://localhost:4175 --包括实例管理、设置和审核日志查看器。

# Custom port
npx nowaikit web --port 3000

# Expose to network (use with caution)
npx nowaikit web --host 0.0.0.0

# Don't auto-open browser
npx nowaikit web --no-open

选项C——桌面应用程序

从以下网址下载本机桌面应用程序(macOS、Windows、Linux) 。包括可视化设置向导、工具浏览器和审核日志查看器。

选项D——手动设置

git clone https://github.com/aartiq/nowaikit.git && cd nowaikit
npm install && npm run build
cp .env.example .env   # fill in your ServiceNow credentials

然后将您的AI客户端指向 dist/server.js --看 支持的AI客户端 在......下面

没有ServiceNow实例? 获取免费的个人开发者实例 developer.servicenow.com --几分钟内准备好。

完整安装指南→ docs/INSTALLATION.md

______________________________________________________________________

客户端设置指南

为每个主要的AI客户端逐步设置——Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed、GitHub Copilot、Continue.dev、Cline、JetBrains、Amazon Q、Google AI Studio、ChatGPT、Grok、Ollama等等。

完整指南→ docs/CLIENT_SETUP.md

有关快速设置片段,请参阅 支持的AI客户端 下面的部分。

交互示例

连接后,用简单的语言问你的人工智能助手:

ITSM和变更管理:

Show me all open P1 incidents assigned to the Network Operations group.
Create a normal change request for deploying the new API gateway — implementation planned for Saturday midnight.
What CMDB CIs does the ERP application depend on?

脚本编写与开发:

List all client scripts on the incident table and show me the ones that fire on form load.
Create a UI action button "Escalate to L3" on the incident form that assigns the ticket to the L3-Support group.
Show me all ACL rules for the change_request table that restrict the "delete" operation.

服务门户和UI生成器:

List all widgets in the Service Portal that contain "catalog" in their name.
Get the full source code of the "Stock Ticker" widget so I can update its server script.
Create a new portal widget called "My Approvals Widget" with a simple Angular template that lists pending approvals.

集成和事件:

List all REST Message definitions that connect to external APIs.
Show me all transform maps that target the incident table.
Fire the custom event "myapp.ticket.escalated" on incident INC0012345.

通知和附件:

List all email notifications that trigger on the incident table when a comment is added.
Upload a screenshot of the error (base64) as an attachment to incident INC0012345.
Show me all failed email log entries from the last 24 hours.

性能分析和数据质量:

Get the current scorecard for the "Mean Time to Resolve" PA indicator with a 30-day trend.
Check the data completeness of the incident table — how many incidents are missing assignment_group or category?
Compare record counts across incident, change_request, and problem tables.

ATF、报告和计划作业:

Run the Regression Test Suite and show me any failures with ATF Failure Insight details.
Summarise the last 30 days of incident trends by category.
Create a scheduled job that runs daily at 3am to archive closed incidents older than 90 days.

有关120多个具有输入、输出和高级工作流的真实示例,请参阅 示例.md.

______________________________________________________________________

删除命令和@提及

连接后,键入 / 在Claude Desktop或Cursor中查看内置的ServiceNow快捷方式:

命令它的作用
/morning-standupP1/P2未结事件、今天到期的变更、SLA违规
/my-tickets分配给您的所有未完成任务/事件
/p1-alerts具有开放时间和受让人的主动P1事件
/my-changes您的待处理变更请求和审批状态
/create-incident引导事件创建
/sla-breaches当前违反SLA的记录
/ci-healthCMDB CI健康检查
/run-atf触发ATF测试套件
/switch-instance交互式实例选择器
/knowledge-search搜索知识库文章
/deploy-updateset引导更新集提交

类型 @ 将实时ServiceNow数据拉入您的AI环境:

提及退货
@my-incidents您的公开事件
@open-changes待处理的变更请求
@sla-breaches立即违反SLA的记录
@instance:info当前实例元数据
@ci:按名称列出CMDB CI
@kb:按标题分类的知识文章

在中添加您自己的命令 nowaikit.commands.json:

[
  {
    "name": "my-p1-runbook",
    "description": "P1 runbook for my team",
    "template": "List all P1 incidents in the Network category. For each: number, description, assignee, time open. Flag SLA breaches."
  }
]

高级配置

主题指南
OAuth 2.0设置(ServiceNow OAuth应用程序创建)docs/SERVICENOW_OAUTH_SETUP.md
多实例/多客户(开发、暂存、生产、租户)docs/MULTI_INSTANCE.md
基于角色的工具包
所有环境变量引用docs/INSTALLATION.md

专业版/企业版功能

以下功能在中可用 NowAIKit Pro企业 版本:

功能版本
HTTP API服务器和web仪表板专业版
桌面应用程序(macOS、Windows、Linux)专业版
SSO/OIDC(Okta、Azure AD/Entra、Ping身份)企业
审计日志记录(JSONL+SIEM webhooks)企业
组织策略治理(MDM/GPO部署)企业

了解更多信息,请访问 nowaikit.com/#定价.

______________________________________________________________________

在行动中看到它

一旦NowAIKit连接,您就可以与您的AI进行真正的交互:

操作——简明英语:

You: "Show me all P1 incidents opened this week that are still unresolved"
You: "Which assignment groups have the most open incidents right now?"
You: "Find all change requests scheduled for this weekend"
You: "Is any SLA about to breach in the next 2 hours?"

开发——AI为您编写和部署:

You: "Create a business rule that auto-assigns high-priority incidents to the NOC group"
You: "Write a client script that validates email format on the contact form"
You: "Create a Service Portal widget that shows my team's open tasks"
You: "Set up a REST Message integration to send alerts to our Slack channel"

人工智能驱动的智能:

You: "Summarise this incident and suggest a resolution based on similar past cases"
You: "Use Predictive Intelligence to categorise this new incident description"
You: "Trigger the SOC Agentic Playbook for this security incident"
You: "What's the trend in P2 incidents over the last 6 months?"

先进的自动化:

You: "Compare record counts between prod and dev for the incident table"
You: "Check data completeness on the cmdb_ci_server table — which fields are mostly empty?"
You: "Run the nightly sync transform map on the latest import set"
You: "Create a scheduled job that emails the on-call team daily at 7am"

多实例和多客户:

You: "List all configured instances"
You: "Switch to customer_acme and show me their open P1 incidents"
You: "Compare open change counts between prod and staging"
You: "Get SLA breach risk from customer_globex prod instance"

示例.md 所有ServiceNow模块中的120多个真实示例。

______________________________________________________________________

支持的AI客户端

任何兼容MCP的AI都可以工作。 现在,AIKit已经在每个主要的人工智能助手、编辑器和代理框架上进行了测试。选择你的,并按照下面的3步设置进行操作。

人工智能助理和聊天

Claude Desktop — Anthropic (Mac / Windows / Linux)

  1. 从以下位置安装Claude Desktop claude.ai/下载
  2. 编辑配置:

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

  1. 添加此块-- 单一实例 (替换路径和凭据):
{
  "mcpServers": {
    "nowaikit": {
      "command": "node",
      "args": ["/absolute/path/to/nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password",
        "WRITE_ENABLED": "false"
      }
    }
  }
}

或使用 多实例 (dev+staging+prod,或多个客户租户):

{
  "mcpServers": {
    "nowaikit": {
      "command": "node",
      "args": ["/absolute/path/to/nowaikit/dist/server.js"],
      "env": {
        "SN_INSTANCES_CONFIG": "/absolute/path/to/instances.json"
      }
    }
  }
}

复制 instances.example.jsoninstances.json,填写您的实例,然后问:

*“列出实例”* → *“切换到prod”* → *“显示所有P1事件”* *“从customer_acme获取打开的更改”* (使用 instance 每次调用的参数)
  1. 重新启动克劳德桌面。锤子图标确认连接。

完整指南→ 客户端/克劳德桌面/SETUP.md | docs/MULTI_INSTANCE.md

ChatGPT / OpenAI (API)

OpenAI通过以下方式支持MCP 响应API (mcp 最新SDK(v1.50+)中的工具类型:

from openai import OpenAI
import os, subprocess

# Start NowAIKit as a subprocess MCP server
proc = subprocess.Popen(
    ["node", "/path/to/nowaikit/dist/server.js"],
    stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
    env={**os.environ,
         "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
         "SERVICENOW_AUTH_METHOD": "basic",
         "SERVICENOW_BASIC_USERNAME": "admin",
         "SERVICENOW_BASIC_PASSWORD": "your_password"}
)

client = OpenAI()
# Use with Responses API tool type "mcp" or via function calling
response = client.responses.create(
    model="gpt-4o",
    tools=[{"type": "mcp", "server_label": "nowaikit"}],
    input="Show me all open P1 incidents"
)

完整指南→ docs/CLIENT_SETUP.md

Google Gemini / Vertex AI (API)

  1. 立即安装AIKit: npm install -g nowaikit
  2. 使用Python客户端 clients/gemini/:
pip install google-generativeai
python clients/gemini/servicenow_gemini_client.py

完整指南→ 客户/双子座/SETUP.md

Google AI Studio — Gemini 2.5 Flash / Pro / Gemini 3 (MCP Preview)

Google AI Studio通过其代理执行环境(目前处于预览阶段)支持MCP服务器。

  1. 首选 aistudio.google.com 并打开 构建→ Agent
  2. 工具 面板中,添加一个MCP服务器并将其指向您的NowAIKit实例:
{
  "name": "nowaikit",
  "transport": "stdio",
  "command": "node",
  "args": ["/absolute/path/to/nowaikit/dist/server.js"],
  "env": {
    "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
    "SERVICENOW_AUTH_METHOD": "basic",
    "SERVICENOW_BASIC_USERNAME": "admin",
    "SERVICENOW_BASIC_PASSWORD": "your_password",
    "WRITE_ENABLED": "false"
  }
}
  1. 或者,使用 API双子星 通过映射NowAIKit工具定义直接使用函数调用:
import google.generativeai as genai
import subprocess, json, os

# Start NowAIKit MCP server
proc = subprocess.Popen(
    ["node", "/path/to/nowaikit/dist/server.js"],
    stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
    env={**os.environ,
         "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
         "SERVICENOW_AUTH_METHOD": "basic",
         "SERVICENOW_BASIC_USERNAME": "admin",
         "SERVICENOW_BASIC_PASSWORD": "your_password"}
)

genai.configure(api_key=os.environ["GOOGLE_API_KEY"])
model = genai.GenerativeModel("gemini-3.1-pro")  # or gemini-3-flash, gemini-2.5-flash
# Use model.generate_content() with tools= mapped from NowAIKit definitions

完整指南→ docs/CLIENT_SETUP.md

Grok (xAI) — via OpenAI-compatible API

  1. Grok使用与OpenAI兼容的API格式。遵循上面的OpenAI设置
  2. base_url="https://api.x.ai/v1" 和你的 XAI_API_KEY

完整指南→ docs/CLIENT_SETUP.md

______________________________________________________________________

AI代码编辑器

Cursor — AI-first code editor

  1. 打开的游标→ 设置→ MCP
  2. 添加服务器配置:
{
  "mcpServers": {
    "nowaikit": {
      "command": "node",
      "args": ["/absolute/path/to/nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password",
        "WRITE_ENABLED": "true",
        "SCRIPTING_ENABLED": "true"
      }
    }
  }
}
  1. 重新启动游标。在聊天中提问: *“列出所有未解决的P1事件”*

多实例: 将env块替换为 "SN_INSTANCES_CONFIG": "/path/to/instances.json" 连接到多个租户。

完整指南→ 客户端/光标/SETUP.md

Windsurf (Codeium) — AI-native editor

  1. 开放式风帆→ 级联→ 配置MCP
  2. 添加与上面的Cursor相同的JSON块
  3. 重新加载Windsurf窗口

完整指南→ docs/CLIENT_SETUP.md

Zed Editor — collaborative AI editor

  1. 打开Zed→ ~/.config/zed/settings.json
  2. 添加到下面 "context_servers":
{
  "context_servers": {
    "nowaikit": {
      "command": { "path": "node", "args": ["/path/to/nowaikit/dist/server.js"] },
      "settings": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password"
      }
    }
  }
}

完整指南→ docs/CLIENT_SETUP.md

______________________________________________________________________

IDE扩展

VS Code — Native MCP (v1.99+, no subscription required)

VS Code 1.99及更高版本包含内置的MCP支持,无需扩展或订阅。

  1. 安装 VS代码1.99+
  2. 创建 .vscode/mcp.json 在您的工作区中(或编辑用户设置):
{
  "servers": {
    "nowaikit": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password",
        "WRITE_ENABLED": "true",
        "SCRIPTING_ENABLED": "true"
      }
    }
  }
}
  1. 打开命令选项板(Cmd/Ctrl+Shift+P) → MCP:列出服务器 验证连接
  2. 打开Copilot Chat(或VS Code中的任何AI助手)并使用 @nowaikit 或者自然地问
提示: 添加 .vscode/mcp.json.gitignore 如果它包含凭据,或使用来自 .env 文件。

完整指南→ 客户端/vcode/SETUP.md

VS Code — GitHub Copilot (agent mode)

  1. 安装VS Code+GitHub Copilot扩展
  2. 创建 .vscode/mcp.json 在您的项目中:
{
  "servers": {
    "nowaikit": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/../../nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password"
      }
    }
  }
}
  1. 打开Copilot聊天→ 代理模式→ @nowaikit

完整指南→ 客户端/vcode/SETUP.md

VS Code — Continue.dev (open-source Copilot alternative)

  1. 安装 继续 来自VS代码市场
  2. 编辑 ~/.continue/config.json:
{
  "mcpServers": [
    {
      "name": "nowaikit",
      "command": "node",
      "args": ["/path/to/nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password"
      }
    }
  ]
}

完整指南→ docs/CLIENT_SETUP.md

VS Code — Cline (autonomous AI agent)

  1. 安装 克莱恩 来自VS代码市场
  2. 开放式诊所→ MCP服务器→ 添加服务器
  3. 输入路径 nowaikit/dist/server.js 以及您的环境变量

完整指南→ docs/CLIENT_SETUP.md

JetBrains AI Assistant (IntelliJ IDEA, PyCharm, WebStorm, etc.)

  1. 安装JetBrains AI助手插件
  2. 前往设置→ 工具→ AI助手→ MCP服务器
  3. 添加一个新服务器,路径为 nowaikit/dist/server.js
  4. 在服务器配置对话框中设置环境变量

完整指南→ docs/CLIENT_SETUP.md

Amazon Q Developer (AWS CLI + IDE)

  1. 为VS Code或IntelliJ安装Amazon Q Developer扩展
  2. 通过配置MCP ~/.aws/amazonq/mcp.json:
{
  "mcpServers": {
    "nowaikit": {
      "command": "node",
      "args": ["/path/to/nowaikit/dist/server.js"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
        "SERVICENOW_AUTH_METHOD": "basic",
        "SERVICENOW_BASIC_USERNAME": "admin",
        "SERVICENOW_BASIC_PASSWORD": "your_password"
      }
    }
  }
}

完整指南→ docs/CLIENT_SETUP.md

______________________________________________________________________

CLI和终端代理

Claude Code / Claude CLI — Anthropic's official CLI

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Register NowAIKit as an MCP server
claude mcp add nowaikit node /absolute/path/to/nowaikit/dist/server.js \
  --env SERVICENOW_INSTANCE_URL=https://yourinstance.service-now.com \
  --env SERVICENOW_AUTH_METHOD=basic \
  --env SERVICENOW_BASIC_USERNAME=admin \
  --env SERVICENOW_BASIC_PASSWORD=your_password

# Verify
claude mcp list

# Use it
claude "Show me all unresolved P1 incidents"

完整指南→ 客户端/claude代码/SETUP.md

Ollama — run AI locally (Llama, Mistral, Phi, etc.)

  1. 安装 奥拉玛 并拉取一个模型: ollama pull llama3
  2. 使用配置为使用Ollama作为模型的MCP兼容客户端(例如Cline或Continue)
  3. 将MCP服务器指向 nowaikit/dist/server.js

完整指南→ docs/CLIENT_SETUP.md

______________________________________________________________________

程序化/代理SDK

OpenAI Codex / Custom Python Agent

cd clients/codex
pip install -r requirements.txt
cp .env.basic.example .env  # fill in your credentials
python servicenow_openai_client.py

完整指南→ 客户端/codex/SETUP.md

Anthropic Agent SDK (Claude API)

import anthropic, subprocess, json

# Start NowAIKit subprocess
proc = subprocess.Popen(
    ["node", "/path/to/nowaikit/dist/server.js"],
    stdin=subprocess.PIPE, stdout=subprocess.PIPE,
    env={**os.environ,
         "SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
         "SERVICENOW_AUTH_METHOD": "basic",
         "SERVICENOW_BASIC_USERNAME": "admin",
         "SERVICENOW_BASIC_PASSWORD": "your_password"}
)
# Then use with the Anthropic MCP client SDK

拟人化MCP Python SDK 为了实现全面整合。

______________________________________________________________________

快速参考

客户端类型身份验证指南
Claude Desktop桌面应用程序基本版,OAuth设置
Claude Code CLI终端基本版,OAuth设置
光标人工智能编辑器基本,OAuth设置
Windsurf人工智能编辑器基本版,OAuth设置
Zed人工智能编辑器基本版,OAuth设置
VS代码 (原生MCP 1.99+)集成开发环境基本版,OAuth设置
VS代码+GitHub副本集成开发环境基础,OAuth设置
VS代码+继续开发集成开发环境基本,OAuth设置
VS代码+临床集成开发环境基础,OAuth设置
JetBrains AIIDE基础版,OAuth设置
Amazon Q开发人员IDE/CLI基本版,OAuth设置
ChatGPT/OpenAIAPI基本,OAuth设置
谷歌AI工作室API/Agent基本,OAuth设置
Google Gemini APIAPI基本,OAuth设置
Grok(xAI)API基础,OAuth设置
Ollama(当地)当地基础设置
Anthropic Agent SDKPythonBasic,OAuth设置

______________________________________________________________________

v2.5的新增功能

桌面应用程序和Web仪表板中的多提供商AI聊天

nowaikit桌面和Web仪表板支持 5家人工智能提供商 并排——所有提供者都可以使用完整的代理工具。所有型号列表都与每个提供商的最新版本保持一致。

  • 提供商切换器 --在聊天标题中单击一下即可在提供商之间切换;每个提供者模型下拉列表会自动更新
  • 克劳德(人类学) --作品4.6·十四行诗4.6·俳句4.5
  • ChatGPT/OpenAI --GPT-5.2·GPT-5.2 Pro·GPT-5.1·GPT-5 mini·GPT-五nano·GPT-4.1·GPT-4o·o3·o4 mini
  • 双子座(谷歌人工智能) --双子座3.1专业版·双子座3专业版·双子3 Flash·2.5专业版·2.5 Flash·2.5 Flash精简版
  • Groq(免费) --《骆驼4》Maverick·《骆驼4:童子军》·《骆驼3.3》70B·《骆驼3.1》8B——超快速推理,无需信用卡
  • OpenRouter(200多种型号) --OpenAI o1 Pro、xAI Grok 4、Claude Opus 4.6、Gemini 2.5 Flash、DeepSeek R1、Llama 4 Maverick等的统一网关——提供许多免费等级
  • o3/o4推理模型支持 --自动检测跳过系统消息并切换到 max_completion_tokens;工具未发送到不支持它们的模型

应用内提供商登录

设置→ AI提供商现在展示了一个统一的 “登录到{Provider}” 每个提供者的流量:

  1. 点击 登录到Claude/ChatGPT/Gemini/Groq/OpenRouter -提供商的API密钥门户在系统浏览器中打开
  2. 登录您的帐户并创建/复制API密钥
  3. 将其直接粘贴到显示的焦点输入中
  4. 点击 验证密钥 --在保存之前,轻量级验证调用会确认密钥有效

每个提供者面板都显示一个清晰的 订阅说明 解释API访问与消费者订阅是分开的(Claude.ai Pro、ChatGPT Plus、Gemini Advanced)。Groq和OpenRouter提供慷慨的免费等级,无需信用卡。

聊天中的Slash命令工具选择器

类型 / 在聊天输入中打开所有400多个ServiceNow工具的浮动选择器:

  • 键入时按工具名称或描述筛选
  • / 导航· 选项卡进入 选择· 退出键 关闭
  • 插入 /toolname 在你的信息中——人工智能知道调用那个特定的工具

其他桌面改进

  • 测试键按钮 -在API键输入上内联;调用提供者的模型列表端点进行验证,而不发送聊天消息
  • 服务器健康自动恢复 --每8秒轮询一次;“离线”状态会自动恢复,无需重新启动应用程序
  • 仪表板URL截断 --长实例URL被截断为 (悬停时显示完整URL)
  • Bug修复:ChatGPT和Gemini响应现在显示正确 --由于提供者响应转换和呈现器之间的内容格式不匹配,响应被默默地丢弃;现在对于提供程序和HTTP API服务器都已完全修复

完整更新日志

v2.4的新增功能

零配置设置和桌面体验

  • npx nowaikit setup --交互式向导自动检测并写入每个AI客户端的配置。没有JSON编辑。
  • nowaikit桌面 --跨平台Electron应用程序(macOS、Windows、Linux),具有8步可视化向导、仪表板、工具浏览器和审计日志。无需单独安装服务器。
  • Web仪表板 --服务于 http://localhost:3100 通过HTTP服务器。浏览工具、查看运行状况、尾部审计日志。

删除命令和@提及

  • 11内置 / 斜杠命令/morning-standup, /p1-alerts, /my-tickets, /create-incident, /sla-breaches, /ci-health, /run-atf, /switch-instance, /deploy-updateset,以及更多
  • 6 @ 提及资源@my-incidents, @open-changes, @sla-breaches, @instance:info, @ci:, @kb:
  • 通过自定义命令 nowaikit.commands.json

企业功能

  • 审核日志记录 --每个工具调用都记录到JSONL文件+webhook(SIEM集成)。连接到MCP和HTTP服务器。
  • SSO/OIDC --Okta/Entra/Ping IdP→ ServiceNow代币交换。 GET /auth/login + /auth/callback HTTP服务器中的路由。
  • 组织/团队政策 (nowaikit.org.json)--admin部署配置:允许的实例、锁定的工具包、SSO强制、写控制。通过MDM或GPO进行部署。
  • 每用户执行上下文 --身份验证模式: service-account, per-user (OAuth授权码), impersonation查询尊重每个用户的ServiceNow ACL。

应用构建器集成

  • HTTP API服务器 (npm run serve)--Lovable、Bolt、v0、Replit应用程序的REST代理。在服务器端保留凭据。
  • Smithery登记处smithery install nowaikit 一个命令安装。

完整更新日志

v2.3的新增功能

  • 作用域应用程序(App Studio)模块list_scoped_apps, get_scoped_app, create_scoped_app, update_scoped_app
  • 创建/更新报告create_report, update_report 添加到报告模块
  • 创建/更新仪表板create_dashboard, update_dashboard 添加到性能分析
  • 创建门户和页面create_portal, create_portal_page 添加到服务门户模块
  • 创建/更新目录项create_catalog_item, update_catalog_item 添加到目录模块
  • 审批规则create_approval_rule 用于自动审批工作流设置

完整更新日志

v2.2的新增功能

  • 5个新模块:系统属性、更新集管理、虚拟代理创作、IT资产管理、DevOps和管道跟踪
  • 真正的多实例和多客户支持 --从一个会话同时连接到无限个实例(开发、暂存、生产、客户租户)
  • 每个呼叫实例路由 --通行证 instance: "name" 任何工具,或 switch_instance 全球范围内
  • 2个新的角色包devops_engineer, itam_analyst
  • system_administrator 包扩展了系统属性和更新集工具

完整更新日志

v2.1亮点

  • 4个新模块:服务门户和UI生成器、集成中心、通知和附件、性能分析
  • 脚本功能增强 --UI策略、UI操作、ACL管理
  • 报告功能增强 --计划作业CRUD+运行历史记录
  • 现在协助generate_work_notes 人工智能为任何记录起草工作笔记
  • 2个新的角色包portal_developer, integration_engineer
  • 二进制文件上传uploadAttachment() 通过ServiceNow附件API

v2.0中的新增功能

  • HRSD模块 --人力资源案例、服务、简介、入职/离职工作流程
  • CSM模块 --客户案例、账户、联系人、产品、SLA跟踪
  • 安全运营和GRC --SecOps事件、漏洞、风险、控制、威胁情报
  • 流程设计器 --列出、检查、触发和监控流和子流
  • OAuth 2.0 适用于所有AI客户端
  • 基于角色的工具包 --特定于角色的包
  • 现在辅助代理播放手册 --人工智能自动化
  • ATF故障洞察 --测试故障诊断
  • 61个单元测试 涵盖所有权限层、路由和域处理程序
  • 完整的文件 --参考指南 docs/

______________________________________________________________________

文档

指南说明
docs/TOOLS.md所有工具的完整参考,包括参数、返回类型和权限要求
docs/CLIENT_SETUP.md所有AI客户端(Claude、ChatGPT、Gemini、Cursor、VS Code、Windsurf、Continue、Cline、Codex、JetBrains、Ollama)的初学者+高级设置
基于角色的包参考——14个角色包中的每一个都包括哪些工具
docs/NOW_ASSIST.mdNow Assist和AI集成指南——NLQ、AI搜索、Agent Playbook
docs/ATF.mdATF测试指南——套件、试运行、ATF故障洞察
docs/SCRIPTING.md脚本管理——业务规则、脚本包含、UI策略、UI操作、ACL、变更集
文档/报告.md报告和分析——聚合查询、性能分析、计划作业
docs/MULTI_INSTANCE.md通过以下方式进行多实例配置 instances.json 或环境变量
docs/SERVICENOW_OAUTH_SETUP.md在ServiceNow中创建OAuth应用程序以进行安全的API访问
docs/INSTALLATION.md完整的安装指南,包括向导、企业配置、SSO和审核日志记录
客户/可爱/SETUP.mdHTTP API服务器-与Lovable、Bolt、v0、Replit应用程序集成
桌面/BUIDING.md构建Electron桌面应用程序并对其进行代码签名
示例.md120多个具有输入、输出和高级工作流的真实示例

______________________________________________________________________

发展

npm install          # install dependencies
npm run build        # compile TypeScript → dist/
npm test             # run unit tests
npm run dev          # watch mode (hot reload)
npm run type-check   # TypeScript type check only
npm run lint         # lint

项目结构

src/
  server.ts              — MCP server entry point (stdio)
  http-server.ts         — HTTP API server (REST proxy for web apps)
  servicenow/
    client.ts            — ServiceNow REST API client (Basic / OAuth / per-user)
    instances.ts         — Multi-instance manager
    types.ts             — TypeScript type definitions + AuthMode
  tools/
    index.ts             — Tool router & role-based package system
    core.ts, incident.ts, change.ts, problem.ts, task.ts
    knowledge.ts, catalog.ts, user.ts, reporting.ts, atf.ts
    now-assist.ts, script.ts, agile.ts, hrsd.ts, csm.ts
    security.ts, flow.ts, portal.ts, integration.ts, notification.ts
    performance.ts, sys-properties.ts, updateset.ts, va.ts, itam.ts, devops.ts
  prompts/
    index.ts             — MCP prompts registry (/ slash commands)
    itsm.ts              — 11 built-in slash commands
    user-prompts.ts      — Custom commands from nowaikit.commands.json
  resources/
    index.ts             — MCP resources (@ mentions)
  auth/
    sso.ts               — OIDC/SSO module (IdP → ServiceNow token exchange)
  dashboard/
    html.ts              — Web dashboard (served at GET /)
  cli/
    index.ts             — CLI entry point (commander.js)
    setup.ts             — Interactive setup wizard
    detect-clients.ts    — Auto-detect installed AI clients
    config-store.ts      — ~/.config/nowaikit/instances.json
    auth.ts              — nowaikit auth login/logout/whoami
    writers/index.ts     — Write configs to AI client config files
  utils/
    permissions.ts       — Five-tier permission gate functions
    audit.ts             — Structured JSONL audit logger + webhook
    org-config.ts        — Org/team policy loader (nowaikit.org.json)
    errors.ts            — Typed error classes
    logging.ts           — Structured logger
desktop/
  main/                  — Electron main process (Node.js)
  renderer/src/          — React 18 UI (Vite)
  electron-builder.yml   — Cross-platform packaging config
  BUILDING.md            — Desktop build & code-signing guide
tests/
  tools/                 — Unit tests
docs/                    — Reference documentation
clients/
  claude-desktop/        — Claude Desktop setup guide
  cursor/                — Cursor setup guide
  vscode/                — VS Code setup guide
  claude-code/           — Claude Code setup guide
  lovable/               — Lovable/Bolt/v0/Replit HTTP proxy guide
  codex/                 — OpenAI Codex Python client
  gemini/                — Google Gemini Python client
smithery.yaml            — Smithery registry config

______________________________________________________________________

贡献

欢迎捐款。请阅读 贡献.md 在打开pull请求之前。

  • Bug报告和功能请求: 打开一个问题
  • 特别感谢新的工具域、额外的测试或文档改进
  • 所有PR都需要 npm test 通过

______________________________________________________________________

安全

如果您发现安全漏洞,请按照 安全.md。不要公开问题。

______________________________________________________________________

常见问题

我需要了解ServiceNow API才能使用它吗? 不需要。对于初学者来说,你只需连接你的人工智能,用简单的英语提问。该套件自动处理所有API调用。

支持哪些ServiceNow版本? 所有积极支持的ServiceNow版本。该工具包针对最新可用的API,并在最近的三个版本上进行了测试-- 苏黎世, 横滨,以及 上都 --并适用于当前支持的任何实例。

我可以在免费的个人开发人员实例(PDI)上使用它吗? 对。在以下网址获取免费PDI developer.servicenow.com 并在5分钟内连接。

在生产中使用安全吗? 对。默认情况下,权限系统是只读的。必须使用环境变量显式启用写入、脚本和Now Assist功能。使用角色包来限制工具表面。

我可以同时使用多个AI提供商吗? 对。每个AI客户端都有自己的MCP配置,指向相同(或不同)的NowAIKit实例。在相同的ServiceNow环境中并行运行Claude Desktop和Cursor。在nowaikit Desktop应用程序中,您可以在聊天页面内单击一下,在Claude、ChatGPT和Gemini之间切换。

它是否支持多实例/多客户? 对。通过以下方式配置任意数量的实例(prod、staging、dev或多个客户租户) instances.json 或环境变量。使用 list_instances, switch_instance,以及 get_current_instance 管理或传递它们的工具 instance: "name" 任何单独的工具调用。看 docs/MULTI_INSTANCE.md.

免费吗? 完全免费用于个人和商业目的。看 许可证 了解详情。

______________________________________________________________________

许可证

来源可用 --免费用于个人和商业目的。有关详细信息,请参阅许可证。

______________________________________________________________________

您唯一需要的ServiceNow AI工具包。

400多种工具。31+模块。每一个AI平台。真正的多实例。免费使用。

现在AIKit •ServiceNow MCP服务器•ServiceNow AI代理•ServiceNow克劳德集成•ServiceNow ChatGPT•ServiceNow游标•ServiceNow Gemini•ServiceNow自动化•ServiceNow开发工具•ServiceNow多实例•ServiceNow MSP

如果NowAIKit为您节省时间,请⭐ 启动存储库——它可以帮助其他人找到项目。

](../../stargazers)

由Hardik Benani建造· 阿尔提克。

目录标签

目录标签

TypeScriptClaude开发工具ServiceNow本地部署AI自动化多实例管理ITSM

支持客户端

Claude DesktopClaudeCursorWindsurfClineVS Code

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

oauth

运行时(runtime,运行环境)

Node.js

来源包(packageName,安装包名)

nowaikit

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiooauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP