AI导哈

企业级MCP服务器

企业级模型上下文协议（MCP）服务器，具有ServiceNow集成和健康监控功能，适用于企业工作流管理和系统监控。

  • by maybeswapnil
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 maybeswapnil/enterprise-mcp

使用说明

企业MCP服务器

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

特性

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

快速开始

先决条件

  • Python 3.11+
  • uv包管理器

安装

  1. 克隆存储库：
git clone <repository-url>
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

许可证

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

相关 MCP