Medical Sql MCP

🚀 医療用SQL MCPサーバー

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、大規模言語モデル (LLM) と医療/病院管理データベースを接続することを目的としています。AIアシスタントが構造化されたツールを通じてデータベースの構造を探索し、SQLクエリを実行し、リアルタイムのデータを取得できるようになります。

✨ 主な機能

• 仮想ファイルシステムのナビゲーション (schema_ls): 平坦なデータベーステーブル構造を意味のある仮想ディレクトリツリー（例：/患者サービス/予約表）に変換し、LLMが業務領域をより直感的に理解できるように支援します。
• スマートなスキーマ検索 (get_table_schema): 必要に応じて特定のテーブルの詳細なフィールド定義を取得でき、コンテキストの占有を減らします。
• 安全で制御可能なSQL実行 (query_database):
  • データを取得するためのSQLクエリの実行をサポートします。
  • セキュリティモード: 環境変数 ALLOW_NON_SELECT_QUERIES を使用して、SELECT 以外の操作（INSERT、UPDATE、DELETE など）を許可するかどうかを制御します。デフォルトでは読み取り専用保護が有効になっています。
• 時間認識 (get_current_time): 正確なサーバーの現在時刻を提供し、「今日」や「過去3日間」などの相対的な時間クエリを処理する際の精度を確保します。

🚀 クイックスタート

前提条件

• Node.js (v16 以上)
• MySQL データベースインスタンス
• OpenAI API Key（初回起動時に意味のあるディレクトリ構造を生成するため）

📦 インストール

1. プロジェクトをクローンし、依存関係をインストールします。

   npm install
   

設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の環境変数を設定します。

# データベース接続情報
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_password
DB_DATABASE=hospital_management

# MCPサーバーのポート
PORT=3000

# OpenAI設定 (仮想ディレクトリツリーを構築するため)
OPENAI_API_KEY=sk-your_key_here
OPENAI_BASE_URL=https://api.openai.com/v1

# セキュリティ設定
# false: SELECTクエリのみ許可 (推奨)
# true: すべてのSQL操作を許可
ALLOW_NON_SELECT_QUERIES=false

実行

開発モード：

npm run dev

ビルドして実行：

npm run build
npm start

💻 使用例

基本的な使用法

# 依存関係のインストール
npm install
# 開発モードで実行
npm run dev

高度な使用法

# ビルドして実行
npm run build
npm start

📚 ドキュメント

ツールリスト (MCP Tools)

プロジェクト構造

• src/mcp-server.ts: MCPサーバーのエントリポイントで、ツール (Tools) とリソース (Resources) の処理ロジックを定義しています。
• src/mapping.ts: データベースのメタデータを仮想ファイルシステムツリー構造に変換する役割を担っています。
• src/db.ts: MySQLデータベースの接続プールをラップしています。
• src/llm-logger.ts: LLMの呼び出しログを記録します。
• schema-cache.json: 生成された仮想ディレクトリ構造をキャッシュし、LLMの繰り返し呼び出しを避けます。

注意事項

⚠️ 重要提示

初回実行時、システムはデータベースのテーブル構造を読み取り、LLMを呼び出して意味のあるパスを生成します。これには数秒かかる場合があり、結果は schema-cache.json にキャッシュされます。

💡 使用建议

データの安全性を確保するために、ALLOW_NON_SELECT_QUERIES=false を常に維持することをお勧めします。AIによるデータの変更が明確に必要な場合を除きます。