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.
- package/.claude/settings.local.json +70 -0
- package/CLAUDE.md +777 -0
- package/LICENSE +21 -0
- package/README.md +562 -0
- package/assets/logo.svg +385 -0
- package/config/servicenow-instances.json.example +28 -0
- package/docs/403_TROUBLESHOOTING.md +329 -0
- package/docs/API_REFERENCE.md +1142 -0
- package/docs/APPLICATION_SCOPE_VALIDATION.md +681 -0
- package/docs/CLAUDE_DESKTOP_SETUP.md +373 -0
- package/docs/CONVENIENCE_TOOLS.md +601 -0
- package/docs/CONVENIENCE_TOOLS_SUMMARY.md +371 -0
- package/docs/FLOW_DESIGNER_GUIDE.md +1021 -0
- package/docs/IMPLEMENTATION_COMPLETE.md +165 -0
- package/docs/INSTANCE_SWITCHING_GUIDE.md +219 -0
- package/docs/MULTI_INSTANCE_CONFIGURATION.md +185 -0
- package/docs/NATURAL_LANGUAGE_SEARCH_IMPLEMENTATION.md +221 -0
- package/docs/PUPPETEER_INTEGRATION_PROPOSAL.md +1322 -0
- package/docs/QUICK_REFERENCE.md +395 -0
- package/docs/README.md +75 -0
- package/docs/RESOURCES_ARCHITECTURE.md +392 -0
- package/docs/RESOURCES_IMPLEMENTATION.md +276 -0
- package/docs/RESOURCES_SUMMARY.md +104 -0
- package/docs/SETUP_GUIDE.md +104 -0
- package/docs/UI_OPERATIONS_ARCHITECTURE.md +1219 -0
- package/docs/UI_OPERATIONS_DECISION_MATRIX.md +542 -0
- package/docs/UI_OPERATIONS_SUMMARY.md +507 -0
- package/docs/UPDATE_SET_VALIDATION.md +598 -0
- package/docs/UPDATE_SET_VALIDATION_SUMMARY.md +209 -0
- package/docs/VALIDATION_SUMMARY.md +479 -0
- package/jest.config.js +24 -0
- package/package.json +61 -0
- package/scripts/background_script_2025-09-29T20-19-35-101Z.js +23 -0
- package/scripts/link_ui_policy_actions_2025-09-29T20-17-15-218Z.js +90 -0
- package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-47-06-790Z.js +30 -0
- package/scripts/set_update_set_Integration_Governance_Framework_2025-09-29T19-59-33-152Z.js +30 -0
- package/scripts/set_update_set_current_2025-09-29T20-16-59-675Z.js +24 -0
- package/scripts/test_sys_dictionary_403.js +85 -0
- package/setup/setup-report.json +5313 -0
- package/src/config/comprehensive-table-definitions.json +2575 -0
- package/src/config/instance-config.json +4693 -0
- package/src/config/prompts.md +59 -0
- package/src/config/table-definitions.json +4681 -0
- package/src/config-manager.js +146 -0
- package/src/mcp-server-consolidated.js +2894 -0
- package/src/natural-language.js +472 -0
- package/src/resources.js +326 -0
- package/src/script-sync.js +428 -0
- package/src/server.js +125 -0
- package/src/servicenow-client.js +1625 -0
- package/src/stdio-server.js +52 -0
- 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
|