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

Related MCP server: ServiceNow MCP Server

Quick Start

Prerequisites

Python 3.11+
uv package manager

Installation

Clone the repository:

git clone <repository-url> cd enterprise-mcp

Install dependencies using uv:

uv sync

Activate the virtual environment:

source .venv/bin/activate

Running the Server

uv run enterprise-mcp

The server will start on http://localhost:3001 by default.

Health Endpoints

GET /health - Basic health check
GET /health/ready - Readiness probe
GET /health/live - Liveness probe

Development

Setup Development Environment

Install development dependencies:

uv sync --extra dev

Install pre-commit hooks:

make dev

Running Tests

make test # or uv run pytest

Code Formatting

make format # or uv run ruff format . uv run ruff check --fix .

Available Make Commands

make help # Show available commands make install # Install dependencies make install-dev # Install dev dependencies make test # Run tests make test-cov # Run tests with coverage make lint # Run linting make format # Format code make run # Run the server make run-dev # Run server in development mode make clean # Clean up build artifacts make dev # Set up development environment

Configuration

The server uses environment variables for configuration. Copy .env.example to .env and customize:

cp .env.example .env

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 URL
SERVICENOW_USERNAME - ServiceNow username
SERVICENOW_PASSWORD - ServiceNow password
HEALTH_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

src/enterprise_mcp/ ├── main.py # Main entry point ├── server/ # Core server implementation │ ├── __init__.py │ ├── base.py # Base server class │ └── mcp_server.py # MCP server implementation ├── services/ # MCP services │ ├── __init__.py │ ├── base_service.py # Base service class │ ├── health/ # Health monitoring service │ │ ├── __init__.py │ │ ├── service.py │ │ └── settings.py │ └── servicenow/ # ServiceNow integration service │ ├── __init__.py │ ├── service.py │ └── settings.py └── settings/ # Configuration settings └── __init__.py

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:

docker build -t enterprise-mcp . docker run -p 3001:3001 enterprise-mcp

License

Enterprise License - See LICENSE file for details.

Enterprise MCP Server

Enterprise MCP Server

Features

Quick Start

Prerequisites

Installation

Running the Server

Health Endpoints

Development

Setup Development Environment

Running Tests

Code Formatting

Available Make Commands

Configuration

Services

Health Service

ServiceNow Service

Architecture

VS Code Integration

Docker Support

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API