Enterprise MCP

🚀 Enterprise MCP Server

The Enterprise MCP Server is an enterprise - grade Model Context Protocol (MCP) server. It integrates with ServiceNow and offers health monitoring capabilities, which greatly enhances enterprise workflows and system stability.

✨ Features

• Health Monitoring: It comes with built - in health checks and monitoring, providing system metrics to keep track of the server's status.
• ServiceNow Integration: There is full ServiceNow MCP service integration, which is essential for enterprise workflows.
• Production Ready: Designed for enterprise environments, it has proper logging and error - handling mechanisms.
• FastAPI Backend: It uses a high - performance REST API powered by Starlette and FastMCP.
• Async Support: It fully supports asynchronous operation, improving efficiency.
• Modular Architecture: It has a service - based architecture with a base service class, making it flexible and scalable.

🚀 Quick Start

Prerequisites

• Python 3.11+
• uv package manager

📦 Installation

1. Clone the repository:

git clone <repository-url>
cd enterprise-mcp

2. Install dependencies using uv:

uv sync

3. Activate the virtual environment:

source .venv/bin/activate

Running the Server

uv run enterprise-mcp

By default, the server will start on http://localhost:3001.

Health Endpoints

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

💻 Usage Examples

Basic Usage

# Start the server
uv run enterprise-mcp

Advanced Usage

# Run the server in development mode
uv run enterprise-mcp --dev

📚 Documentation

Development

Setup Development Environment

1. Install development dependencies:

uv sync --extra dev

2. 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:

Services

Health Service

It provides comprehensive health monitoring, including:

• System health status
• Uptime information
• Memory usage statistics
• CPU usage statistics
• Platform information

ServiceNow Service

It 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.