servicenow-mcp-server 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/.claude/settings.local.json +70 -0
  2. package/CLAUDE.md +777 -0
  3. package/LICENSE +21 -0
  4. package/README.md +562 -0
  5. package/assets/logo.svg +385 -0
  6. package/config/servicenow-instances.json.example +28 -0
  7. package/docs/403_TROUBLESHOOTING.md +329 -0
  8. package/docs/API_REFERENCE.md +1142 -0
  9. package/docs/APPLICATION_SCOPE_VALIDATION.md +681 -0
  10. package/docs/CLAUDE_DESKTOP_SETUP.md +373 -0
  11. package/docs/CONVENIENCE_TOOLS.md +601 -0
  12. package/docs/CONVENIENCE_TOOLS_SUMMARY.md +371 -0
  13. package/docs/FLOW_DESIGNER_GUIDE.md +1021 -0
  14. package/docs/IMPLEMENTATION_COMPLETE.md +165 -0
  15. package/docs/INSTANCE_SWITCHING_GUIDE.md +219 -0
  16. package/docs/MULTI_INSTANCE_CONFIGURATION.md +185 -0
  17. package/docs/NATURAL_LANGUAGE_SEARCH_IMPLEMENTATION.md +221 -0
  18. package/docs/PUPPETEER_INTEGRATION_PROPOSAL.md +1322 -0
  19. package/docs/QUICK_REFERENCE.md +395 -0
  20. package/docs/README.md +75 -0
  21. package/docs/RESOURCES_ARCHITECTURE.md +392 -0
  22. package/docs/RESOURCES_IMPLEMENTATION.md +276 -0
  23. package/docs/RESOURCES_SUMMARY.md +104 -0
  24. package/docs/SETUP_GUIDE.md +104 -0
  25. package/docs/UI_OPERATIONS_ARCHITECTURE.md +1219 -0
  26. package/docs/UI_OPERATIONS_DECISION_MATRIX.md +542 -0
  27. package/docs/UI_OPERATIONS_SUMMARY.md +507 -0
  28. package/docs/UPDATE_SET_VALIDATION.md +598 -0
  29. package/docs/UPDATE_SET_VALIDATION_SUMMARY.md +209 -0
  30. package/docs/VALIDATION_SUMMARY.md +479 -0
  31. package/jest.config.js +24 -0
  32. package/package.json +61 -0
  33. package/scripts/background_script_2025-09-29T20-19-35-101Z.js +23 -0
  34. package/scripts/link_ui_policy_actions_2025-09-29T20-17-15-218Z.js +90 -0
  35. package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-47-06-790Z.js +30 -0
  36. package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-59-33-152Z.js +30 -0
  37. package/scripts/set_update_set_current_2025-09-29T20-16-59-675Z.js +24 -0
  38. package/scripts/test_sys_dictionary_403.js +85 -0
  39. package/setup/setup-report.json +5313 -0
  40. package/src/config/comprehensive-table-definitions.json +2575 -0
  41. package/src/config/instance-config.json +4693 -0
  42. package/src/config/prompts.md +59 -0
  43. package/src/config/table-definitions.json +4681 -0
  44. package/src/config-manager.js +146 -0
  45. package/src/mcp-server-consolidated.js +2894 -0
  46. package/src/natural-language.js +472 -0
  47. package/src/resources.js +326 -0
  48. package/src/script-sync.js +428 -0
  49. package/src/server.js +125 -0
  50. package/src/servicenow-client.js +1625 -0
  51. package/src/stdio-server.js +52 -0
  52. package/start-mcp.sh +7 -0
@@ -0,0 +1,52 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * ServiceNow MCP Server - Stdio Transport
5
+ *
6
+ * Copyright (c) 2025 Happy Technologies LLC
7
+ * Licensed under the MIT License - see LICENSE file for details
8
+ */
9
+
10
+ import dotenv from 'dotenv';
11
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
12
+ import { ServiceNowClient } from './servicenow-client.js';
13
+ import { createMcpServer } from './mcp-server-consolidated.js';
14
+ import { configManager } from './config-manager.js';
15
+
16
+ // Load environment variables
17
+ dotenv.config();
18
+
19
+ async function main() {
20
+ try {
21
+ // Get instance configuration (from SERVICENOW_INSTANCE env var or default)
22
+ const instance = configManager.getInstanceOrDefault(process.env.SERVICENOW_INSTANCE);
23
+
24
+ console.error(`🔗 Default ServiceNow instance: ${instance.name} (${instance.url})`);
25
+ console.error(`💡 Use SN-Set-Instance tool to switch instances during session`);
26
+
27
+ // Create ServiceNow client
28
+ const serviceNowClient = new ServiceNowClient(
29
+ instance.url,
30
+ instance.username,
31
+ instance.password
32
+ );
33
+ serviceNowClient.currentInstanceName = instance.name;
34
+
35
+ // Create MCP server with all tools
36
+ const server = await createMcpServer(serviceNowClient);
37
+
38
+ // Create stdio transport
39
+ const transport = new StdioServerTransport();
40
+
41
+ // Connect server to transport
42
+ await server.connect(transport);
43
+
44
+ console.error('ServiceNow MCP Server (stdio) started successfully');
45
+ console.error(`Instance: ${instance.name} - ${instance.url}`);
46
+ } catch (error) {
47
+ console.error('Failed to start ServiceNow MCP Server:', error);
48
+ process.exit(1);
49
+ }
50
+ }
51
+
52
+ main();
package/start-mcp.sh ADDED
@@ -0,0 +1,7 @@
1
+ #!/bin/bash
2
+ cd /Users/nczitzer/WebstormProjects/mcp-servicenow-nodejs
3
+ export SERVICENOW_INSTANCE_URL=https://dev276360.service-now.com
4
+ export SERVICENOW_USERNAME=admin
5
+ export SERVICENOW_PASSWORD='$h4fG+9nAGeU'
6
+ export SERVICENOW_AUTH_TYPE=basic
7
+ node src/stdio-server.js