Enterprise MCP Server

# 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 1. Clone the repository: ```bash git clone <repository-url> cd enterprise-mcp ``` 2. Install dependencies using uv: ```bash uv sync ``` 3. Activate the virtual environment: ```bash source .venv/bin/activate ``` ### Running the Server ```bash 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 1. Install development dependencies: ```bash uv sync --extra dev ``` 2. Install pre-commit hooks: ```bash make dev ``` ### Running Tests ```bash make test # or uv run pytest ``` ### Code Formatting ```bash make format # or uv run ruff format . uv run ruff check --fix . ``` ### Available Make Commands ```bash 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: ```bash 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: ```bash docker build -t enterprise-mcp . docker run -p 3001:3001 enterprise-mcp ``` ## License Enterprise License - See LICENSE file for details.