Enables configuration through environment variables, supporting customization of server settings like host, port, and integration credentials.
Powers the high-performance REST API backend with Starlette and FastMCP, providing async support for enterprise-grade request handling.
Offers streamlined development workflows through make commands for installation, testing, code formatting, and server operation.
Implements git hooks for automated code quality checks during the development process.
Provides comprehensive test coverage for the MCP server components and services.
Serves as the core runtime environment for the MCP server, requiring version 3.11+.
Handles code formatting and linting to maintain code quality standards.
Enterprise MCP Server
Enterprise-grade Model Context Protocol (MCP) server with ServiceNow integration and health monitoring capabilities.
Features
- Health Monitoring: Built-in health checks and monitoring with system metrics
- ServiceNow Integration: Full ServiceNow MCP service integration for enterprise workflows
- Production Ready: Designed for enterprise environments with proper logging and error handling
- FastAPI Backend: High-performance REST API with Starlette and FastMCP
- Async Support: Full asynchronous operation support
- Modular Architecture: Service-based architecture with base service class
Quick Start
Prerequisites
- Python 3.11+
- uv package manager
Installation
- Clone the repository:
- Install dependencies using uv:
- Activate the virtual environment:
Running the Server
The server will start on http://localhost:3001
by default.
Health Endpoints
GET /health
- Basic health checkGET /health/ready
- Readiness probeGET /health/live
- Liveness probe
Development
Setup Development Environment
- Install development dependencies:
- Install pre-commit hooks:
Running Tests
Code Formatting
Available Make Commands
Configuration
The server uses environment variables for configuration. Copy .env.example
to .env
and customize:
Available settings:
HOST
- Server host (default: 0.0.0.0)PORT
- Server port (default: 3001)DEBUG
- Debug mode (default: false)MCP_BASE
- MCP base URL (default: http://localhost:3001)SERVICENOW_INSTANCE
- ServiceNow instance URLSERVICENOW_USERNAME
- ServiceNow usernameSERVICENOW_PASSWORD
- ServiceNow passwordHEALTH_CHECK_INTERVAL
- Health check interval in seconds (default: 30)
Services
Health Service
Provides comprehensive health monitoring including:
- System health status
- Uptime information
- Memory usage statistics
- CPU usage statistics
- Platform information
ServiceNow Service
Integrates with ServiceNow instances for enterprise workflow management:
- Get incidents
- Create incidents
- Update incidents
- Get change requests
Architecture
VS Code Integration
The project includes VS Code configuration for MCP debugging:
.vscode/mcp.json
- MCP server configuration.vscode/tasks.json
- Build and run tasks.devcontainer/
- Development container setup
Docker Support
Build and run with Docker:
License
Enterprise License - See LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A production-ready Model Context Protocol server that integrates with ServiceNow for enterprise workflows and provides comprehensive health monitoring capabilities.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server for tracking personal health and well-being, offering tools for workout logging, nutrition management, and daily journaling with AI-assisted analysis integration.Last updated -7Python
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.Last updated -21PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server designed to facilitate Nextflow development and testing, providing tools for building from source, running tests, and managing the Nextflow development environment.Last updated -1Python
- -securityFlicense-qualityA lightweight Model Context Protocol server that enables creating, managing, and querying model contexts with integrated Datadog metrics and monitoring.Last updated -Python