MCP Server for ServiceNow

servicenow-mcp

一个 MCP（Model Context Protocol）服务，可让 Claude 与 ServiceNow 实例交互。它将 ServiceNow 功能作为工具提供，Claude 可以通过 Claude Desktop 或任何兼容 MCP 的客户端直接调用这些工具。

要求

• Python 3.10+
• ServiceNow 实例（开发者实例也可以）
• Claude Desktop 或其他 MCP 客户端

安装

pip install -r requirements.txt

如需基于 RAG 的知识搜索（可选）：

pip install chromadb sentence-transformers

配置

设置以下环境变量（或将 .env.example 复制为 .env）：

SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password

# Optional — enables semantic knowledge search
OPENAI_API_KEY=your-openai-key

选择传输方式

此服务支持两种传输方式：

传输方式	使用场景
stdio（默认）	Claude Desktop — 标准本地配置
http	Cursor、Cline、LangChain、OpenAI Agents SDK 及任何 Web 客户端

Claude Desktop 配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "servicenow": {
      "command": "python",
      "args": ["-m", "servicenow_mcp"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_PASSWORD": "your-password"
      }
    }
  }
}

HTTP 传输（Cursor、Cline、LangChain、OpenAI Agents SDK）

以 HTTP 模式启动服务：

MCP_TRANSPORT=http python -m servicenow_mcp

MCP 端点位于 http://localhost:8000/mcp。

如需对所有请求启用 API 密钥验证：

MCP_TRANSPORT=http MCP_API_KEY=your-secret-key python -m servicenow_mcp

之后，客户端必须在每个请求中包含 Authorization: Bearer your-secret-key。

Cursor / Cline 配置

{
  "mcpServers": {
    "servicenow": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-key"
      }
    }
  }
}

Docker + HTTP 模式

docker run -p 8000:8000 \
  -e MCP_TRANSPORT=http \
  -e MCP_API_KEY=your-secret-key \
  -e SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com \
  -e SERVICENOW_USERNAME=your-username \
  -e SERVICENOW_PASSWORD=your-password \
  servicenow-mcp

包含内容

工具按领域分组为工具包：

类别	工具包
核心开发	脚本、开发、后台脚本、高级开发
数据 / 配置	表、数据导入/导出、更新集、附件
ITSM	事件、变更、问题、请求、审批
CMDB / 发现	CMDB、CSDM、发现、ITAM、ITOM、SAM/HAM
工作流	Flow Designer、管道、规划器
集成	脚本化 REST API、集成中心
UI	UI Builder、服务目录、UX
应用开发	作用域应用、最佳实践、命名规范
测试	ATF、故障排查
知识	文档搜索、知识库、RAG 搜索
安全	治理、模拟用户、事件

使用 Docker 运行

如果不想处理 Python 环境，也可以在 Docker 中运行此服务。

1. 确保已安装并启动 Docker Desktop。

2. 将 .env.example 复制为 .env，并填写 ServiceNow 凭据：

   cp .env.example .env
   # then open .env and set SERVICENOW_INSTANCE_URL, SERVICENOW_USERNAME, SERVICENOW_PASSWORD
   

3. 构建并启动容器：

   docker-compose up --build
   

   首次运行需要一分钟左右来下载并构建所有内容。之后运行速度会很快。

4. 停止容器：

   docker-compose down
   

就这么简单。日志保存在项目目录中的 logs/ 文件夹内。

如果要与 Claude Desktop 配合使用，仍需通过 python -m servicenow_mcp 运行（Claude Desktop 集成通过 stdin/stdout 通信，而不是 HTTP）。如果要将其作为独立服务运行或单独测试，Docker 会更实用。

运行测试

pytest

贡献

参见 CONTRIBUTING.md。

许可证

MIT — 参见 LICENSE。