Enterprise MCP

🚀 企業級MCP服務器

企業級模型上下文協議（MCP）服務器，具備與ServiceNow集成和健康監控功能，可有效解決企業工作流中的模型上下文管理問題，為企業環境提供穩定、高效的服務。

🚀 快速開始

前提條件

• Python 3.11 及以上版本
• uv 包管理器

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd enterprise-mcp

2. 使用 uv 安裝依賴：

uv sync

3. 激活虛擬環境：

source .venv/bin/activate

啟動服務器

uv run enterprise-mcp

服務器默認將在 http://localhost:3001 啟動。

健康檢查端點

• GET /health - 基本健康檢查
• GET /health/ready - 就緒探針
• GET /health/live - 存活探針

✨ 主要特性

• 健康監控：內置健康檢查和系統指標監控功能。
• ServiceNow 集成：與 ServiceNow MCP 服務全面集成，適用於企業工作流。
• 生產就緒：專為企業環境設計，具備完善的日誌記錄和錯誤處理機制。
• FastAPI 後端：基於 Starlette 和 FastMCP 構建的高性能 REST API。
• 異步支持：支持全異步操作。
• 模塊化架構：基於服務的架構，擁有基礎服務類。

📦 安裝指南

前提條件

• Python 3.11+
• uv 包管理器

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd enterprise-mcp

2. 使用 uv 安裝依賴：

uv sync

3. 激活虛擬環境：

source .venv/bin/activate

💻 使用示例

啟動服務器

uv run enterprise-mcp

服務器默認將在 http://localhost:3001 啟動。

健康檢查端點

• GET /health - 基本健康檢查
• GET /health/ready - 就緒探針
• GET /health/live - 存活探針

📚 詳細文檔

開發相關

搭建開發環境

1. 安裝開發依賴：

uv sync --extra dev

2. 安裝預提交鉤子：

make dev

運行測試

make test
# 或者
uv run pytest

代碼格式化

make format
# 或者 
uv run ruff format .
uv run ruff check --fix .

可用的 Make 命令

make help           # 顯示可用命令
make install        # 安裝依賴
make install-dev    # 安裝開發依賴  
make test           # 運行測試
make test-cov       # 運行帶覆蓋率的測試
make lint           # 運行代碼檢查
make format         # 格式化代碼
make run            # 啟動服務器
make run-dev        # 在開發模式下啟動服務器
make clean          # 清理構建產物
make dev            # 搭建開發環境

配置相關

服務器使用環境變量進行配置。將 .env.example 複製為 .env 並進行自定義：

cp .env.example .env

可用的設置項：

• HOST - 服務器主機（默認：0.0.0.0）
• PORT - 服務器端口（默認：3001）
• DEBUG - 調試模式（默認：false）
• MCP_BASE - MCP 基礎 URL（默認：http://localhost:3001）
• SERVICENOW_INSTANCE - ServiceNow 實例 URL
• SERVICENOW_USERNAME - ServiceNow 用戶名
• SERVICENOW_PASSWORD - ServiceNow 密碼
• HEALTH_CHECK_INTERVAL - 健康檢查間隔（秒，默認：30）

服務相關

健康服務

提供全面的健康監控，包括：

• 系統健康狀態
• 正常運行時間信息
• 內存使用統計
• CPU 使用統計
• 平臺信息

ServiceNow 服務

與 ServiceNow 實例集成，用於企業工作流管理：

• 獲取事件
• 創建事件
• 更新事件
• 獲取變更請求

架構相關

src/enterprise_mcp/
├── main.py                    # 主入口點
├── server/                    # 核心服務器實現
│   ├── __init__.py
│   ├── base.py               # 基礎服務器類
│   └── mcp_server.py         # MCP 服務器實現
├── services/                  # MCP 服務
│   ├── __init__.py
│   ├── base_service.py       # 基礎服務類
│   ├── health/               # 健康監控服務
│   │   ├── __init__.py
│   │   ├── service.py
│   │   └── settings.py
│   └── servicenow/           # ServiceNow 集成服務
│       ├── __init__.py
│       ├── service.py
│       └── settings.py
└── settings/                  # 配置設置
    └── __init__.py

VS Code 集成

項目包含用於 MCP 調試的 VS Code 配置：

• .vscode/mcp.json - MCP 服務器配置
• .vscode/tasks.json - 構建和運行任務
• .devcontainer/ - 開發容器設置

Docker 支持

使用 Docker 構建和運行：

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

🔧 技術細節

架構設計

採用模塊化架構，基於服務的設計理念，擁有基礎服務類，便於擴展和維護。核心服務器使用 FastAPI 後端，基於 Starlette 和 FastMCP 構建，具備高性能的 REST API，支持全異步操作。

健康監控

內置健康檢查和系統指標監控功能，通過多個健康檢查端點（如 /health、/health/ready、/health/live）提供系統的健康狀態信息，包括系統健康狀態、正常運行時間、內存使用統計、CPU 使用統計和平臺信息等。

ServiceNow 集成

與 ServiceNow MCP 服務全面集成，可實現獲取事件、創建事件、更新事件和獲取變更請求等功能，滿足企業工作流管理的需求。

📄 許可證

企業許可證 - 詳情請參閱 LICENSE 文件。