Patient Search & Create Tasks MCP Server

患者の検索とタスクの作成を行う MCP サーバー

このプロジェクトは、Flight Health Atlas システムで患者を検索し、新しいタスクを作成するための Model Context Protocol（MCP）サーバーを提供します。

機能

• V2 サーバー（server-v2.ts）：Puppeteer を使用した高度なウェブ自動化と、より信頼性の高いログイン処理を実現します

前提条件

• Node.js 18 以降
• npm または yarn パッケージマネージャー

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd patient-search-mcp

2. 依存関係をインストールします：

npm install

3. 認証情報を更新します auth.ts を開き、LOGIN_CREDENTIALS のメールアドレスとパスワードを自分の認証情報に置き換えます。 デモ目的で、これらはハードコードされています。Cursor AI はデフォルトでは .env ファイルにアクセスできないためです（.cursorignore ファイルを作成して !.env を追加すれば回避できます）。

4. サーバーをビルドします：

npm build:v2      # only build the V2 server
npm run start     # Build and start V2 server

設定

Cursor MCP の場合

Cursor の設定から開ける mcp.json ファイルに、次の内容を追加します。

V2 サーバー（推奨）：

{
  "mcpServers": {
    "patient-search-v2": {
      "command": "node",
      "args": ["/path/to/mcp-search-and-create-task/dist/server-v2.js"]
    }
  }
}

使用方法

利用可能なツール

両方のサーバーで、次のツールを利用できます。

hello_world

• 説明：MCP 接続をテストします
• パラメーター：
  • name（任意）：挨拶する相手の名前

search_patient_v2（V2 サーバー）

• 説明：Puppeteer によるウェブ自動化を使用して患者を検索します
• パラメーター：
  • patient_name（必須）：検索する患者の名前
  • detailed（任意）：詳細情報を返すかどうか

create_new_task（V2 サーバー）

• 説明：新しいタスクを作成します
• パラメーター：
  • task_type（必須）：作成するタスクの種類
  • task_name（必須）：作成するタスクの名前
  • description（任意）：タスクに追加する説明

使用例

// Test connection
await callTool("hello_world", { name: "Aakarsh" });

// Search for a patient (V2 server)
await callTool("search_patient_v2", { 
  patient_name: "John Smith",
  detailed: true 
});

開発

開発モードでの実行

npm run dev

### Starting the Server

```bash
# Latest server
npm start

### Testing

You can test the servers directly using JSON-RPC messages:

```bash
# Test V2 server initialization
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | node dist/server-v2.js

タスク作成をテストするためのサンプルテストファイル test-task-creation も作成しました。サーバーをビルドした後、コマンド node dist/test-task-creation.js でテストを実行できます。

トラブルシューティング

よくある問題

1. ブラウザーの起動に失敗する（V2 サーバー）：

   • システムリソースが十分にあることを確認します
   • --no-sandbox フラグを付けて実行してみます（すでに含まれています）

2. ログインに失敗する：

   • 認証情報が正しいことを確認します
   • Atlas のステージングサイトにアクセスできることを確認します
   • ネットワーク接続を確認します

3. 患者検索で結果が返されない：

   • 患者名のスペルを確認します
   • 正しい環境にログインしていることを確認します
   • 名前の一部で検索してみます

デバッグモード

両方のサーバーは、デバッグ情報を stderr に出力します。詳細なエラーメッセージを確認するには、コンソール出力を監視してください。 また、/dist フォルダーを空にする必要がある場合は、npm run clean を実行できます。

依存関係

• @modelcontextprotocol/sdk：MCP TypeScript SDK
• puppeteer：ウェブ自動化（V2 サーバー）
• dotenv：環境変数の管理