Enterprise MCP

🚀 エンタープライズMCPサーバー

サービスノウとの統合機能とヘルスモニタリング機能を備えた、エンタープライズグレードのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• ヘルスモニタリング：システムメトリクスを用いた組み込みのヘルスチェックとモニタリング機能
• 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

📄 ライセンス

エンタープライズライセンス - 詳細については LICENSE ファイルを参照してください。