⚠️ 项目状态:已暂停
注: 在我探索MCP架构的新方向时,这个存储库目前处于搁置状态。
发生了什么变化?
我正在将此MCP从一个简单的ServiceNow API包装器发展为 业务流程层 它协调多个ServiceNow开发工具。这种新方法可能涉及:
- 与当地开发工具集成
- 跨多个实用程序的工作流自动化
- 个人配置和凭据管理
为什么暂停?
在此实验阶段,存储库可能包含:
- ⚠️ 本地文件路径和特定于环境的配置
- ⚠️ 不适合公开共享的敏感信息
- 🔧 快速的架构更改和突破性的修改
我正在花时间评估这种精心策划的方法是否:
- 足够稳定,可供公众使用
- 可在我的特定设置之外进行概括
- 妥善保管,供公众分发
存储库状态
✅ 此代码仍然可用 作为构建自己的ServiceNow MCP服务器的起点\ ✅ 现有的API包装器功能稳定且可用\ ❌ 活动开发和文档更新已暂停
时间线
我将在未来几周重新评估这个方向。可能的结果:
- 🔄 继续使用新的编排架构(如果可以推广)
- 🔀 拆分为单独的仓库(公共MCP+私有编排器)
- ⏮️ 恢复到最初关注的API包装方法
______________________________________________________________________
问题? 请随时分叉此仓库并根据您的需求进行调整!现有的代码库为ServiceNow MCP开发提供了坚实的基础。
______________________________________________________________________
ServiceNow MCP服务器
用于ServiceNow与Claude Code集成的模型上下文协议(MCP)服务器。
特性
- 对任何ServiceNow表执行完整的CRUD操作
- 专业事件管理
- 支持构建注释的故事管理(rm_Story)
- UI动作创建和管理
- 业务规则管理
- 表模式探索
- 直接ServiceNow REST API集成
设置
- 安装依赖项:
npm install- 在中配置凭据
.env:
SERVICENOW_INSTANCE=https://your-instance.service-now.com/
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password- 测试连接:
npm test- 添加到Claude Code CLI:
claude mcp add servicenow -- node /Users//Documents/Claude/servicenow-mcp-doc/server.js注: -- 命令前需要分隔符。
可用工具
通用表格操作
get_records-查询任何表get_record-通过sys_id获取单个记录create_record-创建新记录update_record-更新现有记录delete_record-删除记录
事件管理
get_incidents-使用筛选器查询事件create_incident-创建新事件update_incident-更新事件状态、任务等。
UI操作
get_ui_actions-列出UI操作(可按表筛选)get_ui_action-获取特定UI操作详细信息create_ui_action-创建新的UI操作update_ui_action-修改现有UI操作
业务规则
get_business_rules-列出业务规则create_business_rule-创建新的业务规则
故事管理
get_stories-使用筛选器查询故事(rm_story)get_story-通过sys_id或故事编号获取特定故事(例如STRY0001234)update_story_build_notes-更新u_build_notes HTML字段以获取文档
架构发现
get_tables-列出可用表格get_table_schema-获取表结构
使用Claude代码
安装后,您可以询问Claude:
- “显示事件表上的所有UI操作”
- “创建发送电子邮件通知的新UI操作”
- “列出分配给我的组的所有未解决事件”
- “为数据库超时问题创建事件”
- “我的ServiceNow实例中有哪些表可用?”
- “获取故事STRY0010001并向我显示详细信息”
- “列出所有正在进行的活动故事”
- “用实施细节更新STRY0010001故事的构建说明”
安全
- 永不承诺
.env文件到版本控制 - 使用具有适当权限的服务帐户
- 考虑将OAuth 2.0用于生产环境
免责声明
这不是一个官方的ServiceNow应用程序。
该工具是一个独立的、社区开发的项目,是:
❌ 并非由ServiceNow,股份有限公司开发。 ❌ 未经ServiceNow,股份有限公司认可或支持。 ❌ 不受任何ServiceNow支持协议或保证的保护
ServiceNow,股份有限公司对以下事项不承担任何责任:
- 此应用程序的功能、可靠性或安全性
- 通过使用此工具生成、修改或删除的任何数据
- 因使用此应用程序而导致的任何问题、损坏或损失
- 此软件的任何支持、维护或更新
此工具使用公开可用的API和模型上下文协议(MCP)与ServiceNow实例进行交互。用户全权负责:
- 确保符合其组织的ServiceNow使用策略
- 服务帐户的正确配置和安全性
- 在其ServiceNow实例中创建或修改的任何数据
- 遵循ServiceNow的服务条款和可接受的使用政策
使用风险自负。始终在非生产环境中进行彻底测试。
