Enterprise MCP Server

企业MCP服务器

具有ServiceNow集成和健康监控功能的企业级模型上下文协议（MCP）服务器。

特性

• 健康监测：内置健康检查和系统指标监控
• ServiceNow集成：用于企业工作流的完整ServiceNow MCP服务集成
• 生产就绪：专为具有适当日志记录和错误处理功能的企业环境而设计
• FastAPI 后端：带有Starlette和FastMCP的高性能REST API
• 异步支持：完全异步操作支持
• 模块化架构：具有基本服务类的基于服务的体系结构

快速开始

先决条件

• Python 3.11+
• uv包管理器

安装

1. 克隆存储库：

git clone 
cd enterprise-mcp

1. 使用uv安装依赖项：

uv sync

1. 激活虚拟环境：

source .venv/bin/activate

运行服务器

uv run enterprise-mcp

服务器将于启动 http://localhost:3001 默认情况下。

健康终点

• GET /health -基本健康检查
• GET /health/ready -准备就绪探针
• GET /health/live -活体探针

发展

设置开发环境

1. 安装开发依赖项：

uv sync --extra dev

1. 安装预提交挂钩：

make dev

运行测试

make test
# or
uv run pytest

代码格式化

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

可用的生成命令

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

配置

服务器使用环境变量进行配置。复制 .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实例集成，用于企业工作流管理：

• 获取事件
• 创建事件
• 更新事件
• 获取更改请求

建筑

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代码集成

该项目包括用于MCP调试的VS代码配置：

• .vscode/mcp.json -MCP服务器配置
• .vscode/tasks.json -构建和运行任务
• .devcontainer/ -开发容器设置

Docker支持

使用Docker构建和运行：

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

许可证

企业许可证-有关详细信息，请参阅许可证文件。