Go MCP Servicenow

立即访问mcp服务

ServiceNow的模型上下文协议（MCP）服务器的Go实现。该服务器使AI助手能够通过标准化协议与ServiceNow实例进行交互。

特性

• 完全支持MCP协议：基于JSON-RPC 2.0的通信
• 多种身份验证方法：基本身份验证、OAuth 2.0、API密钥
• 全面的ServiceNow覆盖：跨多个领域的70多种工具
• 双服务器模式：Stdio（用于本地）和HTTP（用于远程/容器化）
• 只读模式：写入操作的可选限制
• 速率限制：内置保护（每20秒5次通话）

ServiceNow概念

了解这些核心的ServiceNow概念将帮助您有效地使用此MCP服务器：

sys_id

ServiceNow中的每条记录都有一个唯一的32个字符的十六进制标识符，称为 sys_id。这是所有记录的主键。

• 格式：32个十六进制字符（例如。， a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
• 用法：大多数工具接受sys_id或人类可读标识符（如INC0010001）
• 示例：何时 get_incident 回报 sys_id: "6816f79cc0a8016401c5a33be04be441"，使用此值进行更新

显示值vs值

ServiceNow引用字段可以返回原始值或人类可读的显示值：

• 价值：引用记录的sys_id
• 显示值：人类可读的文本（例如，用户的全名而不是sys_id）
• 此服务器返回 display_value 默认情况下，为了可读性

编码查询语法

许多列表工具支持ServiceNow的编码查询语法进行高级过滤：

示例：查找高优先级未解决事件： state=1^priority<=2^ORDERBYDESCsys_created_on

参数格式

记录标识符

大多数工具接受多种标识符格式：

国家价值观

不同的记录类型使用不同的状态代码：

事件:

• 1 新
• 2 =进行中
• 3 =暂停
• 6 =已解决
• 7 =关闭
• 8 =已取消

变更请求:

• -5 新
• -4 =评估
• -3 =授权
• -2 =预定
• -1 =实施
• 0 =审核
• 3 =关闭
• 4 =已取消

优先级和影响值

日期/时间格式

使用ISO 8601格式： YYYY-MM-DD HH:MM:SS

例子： 2024-12-15 14:30:00

工具参考

事件管理

变更管理

服务目录

知识库

用户和组

工作流

脚本包括

变更集（更新集）

敏捷开发

常见工作流

事件生命周期

1. 创建偶发事件: create_incident 随着 short_description 和 category
2. 分配给组/用户: update_incident 随着 assignment_group 或 assigned_to
3. 添加工作笔记: add_incident_comment 随着 is_work_note: true
4. 更新进度: update_incident 随着 state: "2" （进行中）
5. 解决: resolve_incident 随着 resolution_code 和 resolution_notes

变更请求流程

1. 创建更改: create_change_request 随着 type （正常/标准/紧急）
2. 添加任务: add_change_task 对于每个实施步骤
3. 提交审批: submit_change_for_approval
4. 批准/拒绝: approve_change 或 reject_change
5. 跟踪进度: update_change_request 状态更新

知识文章发布

1. 创建文章: create_knowledge_article （创建于草稿状态）
2. 更新内容: update_knowledge_article 精炼
3. 发布: publish_knowledge_article 使可见

用户入职培训

1. 创建用户: create_user 带有必填字段
2. 查找组: list_groups 识别相关群体
3. 添加到组: add_group_members 对于每个组

安装

从源代码构建

git clone https://github.com/elastiflow/go-mcp-servicenow.git
cd go-mcp-servicenow
go build -o go-mcp-servicenow .

码头工人

docker build -t go-mcp-servicenow .

配置

环境变量

身份验证类型

基本身份验证

export SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com"
export SERVICENOW_AUTH_TYPE="basic"
export SERVICENOW_USERNAME="admin"
export SERVICENOW_PASSWORD="password"

OAuth 2.0（客户端凭据）

export SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com"
export SERVICENOW_AUTH_TYPE="oauth"
export SERVICENOW_CLIENT_ID="your_client_id"
export SERVICENOW_CLIENT_SECRET="your_client_secret"

OAuth 2.0（密码授权）

export SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com"
export SERVICENOW_AUTH_TYPE="oauth"
export SERVICENOW_CLIENT_ID="your_client_id"
export SERVICENOW_CLIENT_SECRET="your_client_secret"
export SERVICENOW_USERNAME="admin"
export SERVICENOW_PASSWORD="password"

API密钥

export SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com"
export SERVICENOW_AUTH_TYPE="api_key"
export SERVICENOW_API_KEY="your_api_key"

用法

标准模式（默认）

./go-mcp-servicenow

HTTP模式

./go-mcp-servicenow --http --host 0.0.0.0 --port 3000

命令行选项

HTTP模式详细信息

在HTTP模式下运行时，服务器会公开：

• POST / -MCP JSON-RPC端点
• GET /health -健康检查端点（返回 {"status":"ok","version":"X.X.X"})

认证：HTTP模式需要 Authorization 所有请求的标头（除 /health).授权层是可插拔的；默认情况下，它接受任何令牌。

按请求凭据：在HTTP模式下，ServiceNow凭据可以通过标头而不是环境变量传递，从而启用多用户场景：

这些标头会覆盖相应的环境变量（如果存在）。

码头工人

docker run -p 3000:3000 \
  -e SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com" \
  -e SERVICENOW_AUTH_TYPE="basic" \
  -e SERVICENOW_USERNAME="admin" \
  -e SERVICENOW_PASSWORD="password" \
  go-mcp-servicenow

Claude桌面集成

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "servicenow": {
      "command": "/path/to/go-mcp-servicenow",
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://dev12345.service-now.com",
        "SERVICENOW_AUTH_TYPE": "basic",
        "SERVICENOW_USERNAME": "admin",
        "SERVICENOW_PASSWORD": "password"
      }
    }
  }
}

API端点（HTTP模式）

错误处理

常见错误及解决方法：

发展

项目结构

go-mcp-servicenow/
├── main.go
├── go.mod
├── Dockerfile
├── ecs-task-definition.json
├── README.md
└── pkg/
    ├── mcp/
    │   ├── server.go      # MCP server implementation
    │   └── types.go       # MCP protocol types
    ├── auth/
    │   └── auth.go        # MCP authentication
    ├── logging/
    │   └── logging.go     # Structured logging
    ├── servicenow/
    │   ├── client.go      # ServiceNow API client
    │   └── config.go      # Configuration handling
    └── tools/
        ├── registry.go    # Tool registration
        ├── helpers.go     # Utility functions
        ├── incidents.go   # Incident tools
        ├── catalog.go     # Catalog tools
        ├── change.go      # Change management tools
        ├── knowledge.go   # Knowledge base tools
        ├── users.go       # User/group tools
        ├── workflow.go    # Workflow tools
        ├── script_include.go  # Script include tools
        ├── changeset.go   # Changeset tools
        └── agile.go       # Agile tools

建筑

go build -o go-mcp-servicenow .

测试

go test ./...

许可证

MIT许可证

学分

搬运来的 梯队人工智能实验室/servicenow mcp python