MCP Loinc

🚀 LOINC API MCP サーバー

このプロジェクトは、LOINC API とやり取りするためのモジュール化された Python ラッパーを提供し、MCP プロトコルサーバーインターフェースを介して Claude Desktop にシームレスに統合し、医学用語のスマートな検索と標準化を実現します。

🚀 クイックスタート

LOINC MCP サーバーは、LOINC API との包括的なやり取りを提供し、オンラインとローカルデータベースの両方のモードでの実行をサポートし、Claude Desktop を介してスマートな用語処理を実現します。以下は主な機能と操作ガイドです。

✨ 主な機能

1. モジュール化された Python ラッパー：LOINC API とのやり取りを簡素化する、使いやすいインターフェースを提供します。
2. MCP プロトコル統合：Claude Desktop との接続をサポートし、医学用語のスマートな検索と標準化処理を実現します。
3. 双モード実行：
   • オンラインモード：LOINC API をリアルタイムに呼び出し、最新の用語データを取得します。
   • ローカルデータベースモード：オフライン環境をサポートし、LOINC データベースを事前にダウンロードして保存し、ネットワークがない場合でも使用できます。

📦 インストール

環境要件

• オペレーティングシステム：Linux、Windows または macOS
• Python バージョン：3.6 以上

インストール手順

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

git clone https://github.com/christian-delage/loinc-mcp-server.git
cd loinc-mcp-server

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

pip install -r requirements.txt

LOINC API アクセス権の取得

1. LOINC アカウントを登録する：LOINC 公式サイトにアクセスし、開発者アカウントを作成します。
2. API キーを取得する：ログイン後、開発者ドキュメントにアクセスし、API アクセスキーを申請します。

設定

Claude Desktop の設定

設定ファイルに以下の内容を追加します：

{
  "mcp_server": {
    "host": "localhost",
    "port": 5000,
    "timeout": 30
  }
}

認証

サーバーを起動する際に、以下のコマンドを使用して認証を行います：

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

利用可能な MCP ツール

LOINC コード検索

コードまたは説明を使用して用語情報を検索することができます。例のリクエスト：

{
  "query": "hemoglobin",
  "include_details": true,
  "property_filter": "Mass"
}

LOINC 詳細情報の取得

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

{
  "loinc_code": "2339-0"
}

パネル情報

パネルレベルの用語検索と管理をサポートします。

階層構造ナビゲーション

階層化されたデータを使用して用語の関係を表示し、理解とナビゲーションを容易にします。

💻 使用例

基本的な使用法

{
  "query": "血红蛋白",
  "include_details": true
}

高度な使用法

{
  "query": "白细胞计数",
  "property_filter": "数量",
  "system_filter": "血液"
}

トラブルシューティング

• 結果が空の場合：API キーが有効で、権限が正しいことを確認してください。
• 接続問題が発生した場合：ネットワークの状態を確認するか、ネットワーク環境を変更してみてください。
• 認証エラーが発生した場合：ユーザー名とパスワードを再確認してください。

高度な機能

ローカルデータベースの作成

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

カスタムフィルター

以下の高度なフィルターオプションをサポートしています：

• property_filter：属性でフィルタリングします。
• system_filter：システム（血液、体液など）でフィルタリングします。
• class_filter：分類（CHEM、VOL など）でフィルタリングします。

貢献

貢献を歓迎します！問題や提案をフィードバックするには、Pull Request または Issue を送信してください。

📄 ライセンス

このプロジェクトはオープンソースで、[LICENSE] ライセンスを採用しています。

謝辞

以下の機関と個人に感謝します：

• LOINC が API サポートを提供してくれたこと
• LOINC チームが包括的な医学用語標準を開発してくれたこと
• Claude AI がスマートな統合機能を実現してくれたこと

作成者：Christian Delage（dr.christian.delage@gmail.com）