LOINC API MCP Server

LOINC API MCP サーバー

このプロジェクトでは、LOINC API 用のモジュール式 Python ラッパーと、Claude Desktop にシームレスに統合できる MCP サーバーインターフェースを提供し、医療用語の検索と標準化を支援します。

目次

• 概要
• 機能
• インストール
• LOINC API の利用開始
• 設定
  • Claude Desktop のセットアップ
  • 認証
• 利用可能な MCP ツール
  • LOINC コードの検索
  • LOINC 詳細情報の取得
  • パネル情報
  • 階層のナビゲーション
• 使用例
• トラブルシューティング
• 高度な機能

概要

LOINC MCP サーバーは、Logical Observation Identifiers Names and Codes（LOINC）API サービスへの包括的なインターフェースを提供し、次のことができます。

• さまざまな用語やフィルターを使って LOINC コードを検索する
• 特定の LOINC コードの詳細情報を取得する
• 標準化されたパネルやフォームにアクセスする
• LOINC 用語間の階層関係をたどる
• LOINC 観察項目の回答リストを取得する

構成は次のとおりです。

• loinc_api/ - LOINC API とやり取りするメインパッケージ
  • __init__.py - パッケージの初期化
  • config.py - 設定
  • api.py - HTTP Basic 認証を使用するメイン API クライアント
  • database.py - オフラインアクセス用のローカルデータベースハンドラー

機能

• 包括的な LOINC 検索：コンポーネント、プロパティ、システム、クラスのフィルターオプションを使用して、フリーテキストクエリから LOINC コードを検索します
• LOINC の詳細情報：正式名称、コンポーネント、プロパティ、システム、方法など、あらゆる LOINC コードの詳細情報を取得します
• パネル構造へのアクセス：LOINC パネルとその構成検査を確認します
• 階層のナビゲーション：LOINC 用語間の親子関係をたどります
• 標準化されたフォーム：LOINC の標準化された評価フォームや質問票にアクセスします
• トップ 2000 へのアクセス：最も広く使用されている LOINC コードを取得します
• 回答リスト：特定の LOINC 観察項目の標準化された回答リストを取得します
• デュアルモード動作：オンラインの LOINC API またはローカルデータベースファイルのいずれかを使用できます
• MCP 統合：MCP プロトコルを介して Claude Desktop とシームレスに統合します

インストール

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

   git clone https://github.com/yourusername/loinc-api.git
   cd loinc-api
   

2. 必要な依存関係をインストールします。

   pip install -r requirements.txt
   

LOINC API の利用開始

LOINC API を使用するには、次の手順が必要です。

1. LOINC.org で無料アカウントを登録します
2. 利用規約に同意します
3. 登録後、LOINC.org のユーザー名とパスワードを API 認証に使用できます

設定

Claude Desktop のセットアップ

Claude Desktop と統合するには、Claude Desktop の設定ファイルに次の設定を追加します。

{
  "mcp_servers": [
    {
      "name": "LOINC API",
      "url": "http://localhost:8080",
      "auth": {
        "type": "basic",
        "username": "your_loinc_username",
        "password": "your_loinc_password"
      }
    }
  ]
}

認証

LOINC API は HTTP Basic 認証を使用します。サーバーの起動時に LOINC のユーザー名とパスワードを指定する必要があります。

python loinc_server.py --username=your_loinc_username --password=your_loinc_password

利用可能な MCP ツール

LOINC コードの検索

さまざまなフィルターを使って LOINC コードを検索します。

{
  "query": "glucose",
  "limit": 10,
  "component_filter": "Glucose",
  "system_filter": "Blood",
  "include_details": true
}

LOINC 詳細情報の取得

特定の LOINC コードの詳細情報を取得します。

{
  "loinc_code": "2339-0"
}

パネル情報

LOINC パネルの構造を取得します。

{
  "loinc_code": "24331-1"
}

階層のナビゲーション

親子関係を確認します。

{
  "parent": "LP7839-6"
}

使用例

例 1：グルコース関連の LOINC コードを検索する

{
  "query": "glucose",
  "limit": 5,
  "include_details": true
}

例 2：特定の LOINC コードの詳細情報を取得する

{
  "loinc_code": "2339-0"
}

トラブルシューティング

• 結果が空の場合：LOINC アカウントに適切な権限があること、および正しい認証情報を使用していることを確認してください。
• 接続の問題：インターネット接続を確認し、LOINC API にアクセスできることを確かめてください。
• 認証エラー：LOINC のユーザー名とパスワードが正しいことを確認してください。

高度な機能

• ローカルデータベース：オフラインで使用する場合は、ローカルの LOINC データベースファイルを作成できます。

  python loinc_server.py --create-db --username=your_loinc_username --password=your_loinc_password
  

• カスタムフィルタリング：高度なフィルターを適用して検索結果を絞り込めます。

  {
    "query": "hemoglobin",
    "property_filter": "Mass",
    "system_filter": "Blood",
    "class_filter": "CHEM"
  }
  

貢献

LOINC MCP Server の改善への貢献を歓迎します。プルリクエストの送信や、バグおよび機能リクエストに関する issue の作成をぜひお願いします。

ライセンス

このプロジェクトはオープンソースです。

謝辞

• API を提供している LOINC
• 包括的な医療用語の標準化に取り組む LOINC チーム
• 高度な統合機能を提供する Claude AI

Christian delage が作成（[email protected]）