Case Management MCP

🚀 PatOrgケース管理MCP - Oracle自然言語からSQLへ

このModel Context Protocol (MCP)サーバーは、PatOrgケース管理システム用に自然言語のクエリをOracle SQLに変換します。このリポジトリはOracle専用で、実際のスキーマドキュメントを使用しています。

🚀 クイックスタート

依存関係のインストール

pip install -e .

Oracle資格情報の設定

cp .env.example .env
# .envを編集してOracleの資格情報を入力

テストの実行

pytest tests/test_queries.py -v

Claude Desktopとの統合

詳細なセットアップ手順については、CLAUDE_DESKTOP_INTEGRATION.mdを参照してください。

詳細なセットアップについては、QUICKSTART.mdを参照してください。

✨ 主な機能

このMCPサーバーにより、Claude（または他のAIアシスタント）は以下のことができます。

• 詳細なOracleスキーマドキュメントを読み取る
• クエリパターンとビジネス用語集を確認する
• 自然言語から安全なOracle SQLを生成する
• クエリの実行前に検証する
• 読み取り専用のSELECTクエリを安全に実行する

📦 インストール

1. 依存関係のインストール

   pip install -e .
   

2. Oracle資格情報の設定

   cp .env.example .env
   # .envを編集してOracleの資格情報を入力
   

💻 使用例

基本的な使用法

Claude Desktopと統合した後、自然言語で質問をすることができます。

単純なクエリ

• "AKTEテーブルのすべてのケースファイルを表示して"
• "ユーザーRUHが作成したケースファイルは何ですか？"
• "AKTEテーブルの構造を表示して"
• "CPIDEテーブルには何行ありますか？"

最近のアクティビティ

• "過去30日間に変更されたファイルを表示して"
• "今週作成されたファイルは何ですか？"
• "LOHIテーブルの最近のログインアクティビティを表示して"

ステータスと優先度

• "STATUSAKTがnullでないファイルを表示して"
• "HAKTE = 1のメインファイルを見つけて"
• "高優先度のファイル（PRIOANZ > 0）を表示して"

履歴と変更

• "ファイルMK 118の履歴を表示して"
• "HISTST01の最新の変更は何ですか？"
• "DOVEテーブルのドキュメント履歴を表示して"

関係とJOIN

• "CPIDEからパーティ情報とともにファイルを表示して"
• "ADRSからケースとその住所を見つけて"
• "ドキュメント参照付きのファイルを取得して"

分析

• "作成したユーザーごとにファイルをカウントして"
• "AKTEのステータス分布を表示して"
• "最もアクティブなユーザーは誰ですか？"

Claudeは以下の手順で動作します。

1. スキーマドキュメント（docs/schema.md）を読み取る
2. クエリパターン（docs/patterns.md）を確認する
3. 適切なOracle SQLを生成する
4. 検証ツールを使用して検証する
5. 安全に実行して結果を返す

📚 詳細ドキュメント

プロジェクト構造

patorg-case-mcp-oracle/
├── src/
│   ├── server.py          # MCPサーバーの定義（リソースとツール）
│   ├── db.py              # Oracle接続とクエリ実行
│   └── validators.py      # クエリの検証と安全性チェック
├── docs/
│   ├── schema.md          # Oracleスキーマドキュメント
│   ├── patterns.md        # 自然言語 → SQLの例
│   ├── glossary.md        # ビジネス用語の定義
│   ├── end-to-end-testing.md        # テストガイド
│   └── fastmcp-tools-explained.md   # MCPツールの説明
├── tests/
│   └── test_queries.py    # 検証と実行テスト（pytest）
├── start_mcp_server.py    # MCPサーバーのラッパー（.envの資格情報を読み込む）
├── toggle_mcp.ps1         # MCPを有効/無効にするPowerShellスクリプト
├── toggle_mcp.bat         # トグルスクリプトのWindowsバッチラッパー
├── .env.example           # Oracle資格情報のテンプレート
├── QUICKSTART.md          # クイックスタートガイド
├── CLAUDE_DESKTOP_INTEGRATION.md   # Claude Desktopのセットアップガイド
├── COMPLETION_SUMMARY.md  # プロジェクトの完了概要
├── claude_desktop_config.template.json
├── pyproject.toml
└── README.md

MCPリソースとツール

リソース（読み取り）

• case_schema → docs/schema.md
• query_patterns → docs/patterns.md
• business_glossary → docs/glossary.md
• db_summary → ライブのOracle概要

ツール（実行）

• validate_query
• execute_query

セキュリティ機能

• SELECTのみの実行制限
• Oracleスキーマのテーブルホワイトリスト（AKTE, CPIDE/CPIDD/CPIDF, P7LIST*, HIST*, LOHI, ADRS*, DOVE*, DOKU）
• 大規模テーブルにおけるWHERE句の必須条件
• ブロックされたキーワード（DELETE/INSERT/UPDATEなど）
• SQLコメントのブロック
• FETCH FIRST n ROWS ONLYによる自動行制限

トラブルシューティング

• Oracle接続パラメータが必要 → .envファイルに正しい資格情報があることを確認してください。
• クエリ検証に失敗しました → 安全なクエリパターンについてdocs/patterns.mdを確認してください。
• ClaudeがMCPを認識しない → Claude Desktopを再起動し、設定パスを確認してください。
• インポートエラー → パッケージがインストールされていることを確認してください：pip install -e .
• MCPサーバーが起動しない → python start_mcp_server.pyでテストしてください。

詳細なヘルプについては、以下を参照してください。

• docs/end-to-end-testing.md - 完全なテストガイド
• CLAUDE_DESKTOP_INTEGRATION.md - 統合のトラブルシューティング

ユーティリティスクリプト

• start_mcp_server.py - .envの資格情報でMCPサーバーを起動します（Claude Desktopと一緒に使用します）
• toggle_mcp.ps1 - Claude Desktopの設定でMCPサーバーを有効/無効にします
• toggle_mcp.bat - トグルスクリプトのWindowsラッパー（ダブルクリックでトグル）

テストの実行

# すべてのテストを実行
pytest tests/test_queries.py -v

# 特定のテストを実行
pytest tests/test_queries.py::TestQueryValidator::test_valid_select_queries -v

# 期待結果: 12個のテストが合格

参考資料

• MCPドキュメント
• FastMCP
• python-oracledbドキュメント
• SQLの基礎

バージョン: 1.0.0
最終更新日: 2026年2月
ステータス: 本番環境対応のOracle専用MCPサーバー

主な機能:

• ✅ Oracle専用（すべてのSQLite/モック参照を削除）
• ✅ 適切なPythonパッケージング（pip install -e .）
• ✅ 完全なpytestテストカバレッジ（12個のテスト）
• ✅ 安全な資格情報管理（.envファイル）
• ✅ Claude Desktopとの統合準備完了
• ✅ 簡単な有効/無効切り替え用のトグルスクリプト