AI导哈

嵌入诊断工具

该工具用于检查ServiceNow实例是否已正确配置以在第三方网站上嵌入组件。

  • by gamerxkj
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gamerxkj/embeddables_mcp

使用说明

ServiceNow嵌入诊断MCP服务器

此MCP（模型上下文协议）服务器提供诊断工具，用于检查ServiceNow实例是否正确配置为在第三方网站上嵌入组件。

特性

服务器可以诊断以下配置：

  1. 检查是否通过系统属性启用了可嵌入文件(glide.uxf.lib.embeddables.enabled)
  2. 检查Embeddeds插件是否(com.glide.ux.embeddables)处于活动状态
  3. 检查客户端访问安全插件(com.glide.security.client_access)处于活动状态
  4. 检查是否为特定的第三方域配置了CORS规则
  5. 运行完整的诊断并提供具体建议

先决条件

  • Python 3.8或更高版本
  • 具有管理员访问权限的ServiceNow实例

安装

  1. 克隆此存储库
  2. 安装依赖项：
pip install -r requirements.txt

用法

启动服务器

python servicenow_mcp_server.py

默认情况下，服务器将在端口6060上启动。您可以通过设置来更改端口 PORT 环境变量。

从LLM连接到MCP服务器

此MCP服务器设计用于支持模型上下文协议的AI系统。连接后，MCP服务器将为LLM提供多种工具：

  • connect_to_instance：连接到ServiceNow实例
  • check_embeddables_enabled：检查是否启用了嵌入式
  • check_embeddables_plugin：检查embeddables插件是否处于活动状态
  • check_client_access_plugin：检查客户端访问安全插件是否处于活动状态
  • check_cors_rule：检查特定域是否存在CORS规则
  • run_full_diagnostic：运行所有诊断检查并提供建议

工作流示例

一旦连接到MCP服务器，LLM将能够执行以下操作：

  1. 向用户询问他们的ServiceNow实例URL
  2. 询问用户的用户名和密码
  3. 使用提供的凭据连接到实例
  4. 检查所有必需的配置是否到位
  5. 询问用户要嵌入哪个组件
  6. 询问用户他们想在哪个第三方网站上嵌入它
  7. 检查是否为指定域配置了CORS规则
  8. 为任何缺失的配置提供建议

安全考虑

  • 此服务器不存储任何凭据
  • 与ServiceNow的所有通信都是直接从服务器完成的
  • 对于生产使用，建议实施OAuth身份验证，而不是基本身份验证

API文档

MCP服务器提供标准MCP接口。您可以在以下端点访问API文档：

GET /v0/mcp

这将返回服务器元数据和可用工具及其模式。

在MCP客户端上设置

将此添加到mcp_config.json-

“嵌入式检查mcp”：{ “命令”：“npx”， “args”：[ “mcp远程”， "https://solana-dev.devsnc.com/mcp/servicenow/sse", 头球 “用户名：maint”， 头球 “密码：大” ] }

相关 MCP