Healthcare MCP Public

🚀 医療健康MCPサーバー

この医療健康MCPサーバーは、様々な医療関連のデータを取得するためのAPIを提供します。FDAの薬剤情報、PubMedの文献、健康トピック、臨床試験情報、ICD - 10コードなどを取得できます。

🚀 クイックスタート

このサーバーのAPIを使用することで、医療関連のデータを簡単に取得できます。以下に各APIの詳細を示します。

✨ 主な機能

• FDA薬剤情報の検索
• PubMed文献の検索
• 健康トピックの取得
• 臨床試験情報の検索
• ICD - 10コードの検索

💻 使用例

基本的な使用法

以下は、各APIの基本的な使用例です。

FDA薬剤検索

# FDA薬剤検索の基本的な使用例
# このコードはPythonでFDA薬剤検索APIを呼び出す例です。
# 薬剤名と検索タイプを指定して、薬剤情報を取得します。
import requests

drug_name = "阿司匹林"
search_type = "general"
url = f"http://your_server_address/fda/drugs?brand_name={drug_name}&search_type={search_type}"
response = requests.get(url)
print(response.json())

PubMed検索

# PubMed検索の基本的な使用例
# このコードはPythonでPubMed検索APIを呼び出す例です。
# 検索クエリ、最大結果数、日付範囲を指定して、文献情報を取得します。
import requests

query = "cancer"
max_results = 5
date_range = "5"
url = f"http://your_server_address/pubmed/search?query={query}&max_results={max_results}&date_range={date_range}"
response = requests.get(url)
print(response.json())

健康トピック

# 健康トピック取得の基本的な使用例
# このコードはPythonで健康トピック取得APIを呼び出す例です。
# 健康トピックと言語を指定して、関連情報を取得します。
import requests

topic = "diabetes"
language = "en"
url = f"http://your_server_address/health_topics/{topic}?language={language}"
response = requests.get(url)
print(response.json())

臨床試験検索

# 臨床試験検索の基本的な使用例
# このコードはPythonで臨床試験検索APIを呼び出す例です。
# 医学的状態、試験状態、最大結果数を指定して、臨床試験情報を取得します。
import requests

condition = "hypertension"
status = "all"
max_results = 10
url = f"http://your_server_address/clinical_trials/search?condition={condition}&status={status}&max_results={max_results}"
response = requests.get(url)
print(response.json())

ICD - 10コード検索

# ICD - 10コード検索の基本的な使用例
# このコードはPythonでICD - 10コード検索APIを呼び出す例です。
# ICD - 10コード、医学的状態の説明、最大結果数を指定して、コード情報を取得します。
import requests

code = "A01"
description = None
max_results = 10
url = f"http://your_server_address/icd10/codes?code={code}&description={description}&max_results={max_results}"
response = requests.get(url)
print(response.json())

汎用ツール実行

# 汎用ツール実行の基本的な使用例
# このコードはPythonで汎用ツール実行APIを呼び出す例です。
# ツール名、引数、セッションIDを指定して、ツールを実行します。
import requests
import json

data = {
    "name": "fda_drug_lookup",
    "arguments": {
        "drug_name": "阿司匹林",
        "search_type": "general"
    },
    "session_id": "optional-session-id"
}
url = "http://your_server_address/mcp/call-tool"
headers = {'Content-Type': 'application/json'}
response = requests.post(url, data=json.dumps(data), headers=headers)
print(response.json())

高度な使用法

# 高度な使用例は、基本的な使用例を拡張して、より複雑な検索やデータ処理を行うことができます。
# 例えば、複数のAPIを組み合わせて、医療データの分析や可視化を行うことができます。

📚 ドキュメント

APIエンドポイント

FDA薬剤検索

GET /fda/drugs?brand_name={drug_name}&search_type={search_type}

パラメータ：

• drug_name：検索する薬剤名
• search_type：検索する情報のタイプ
  • general：基本的な薬剤情報（デフォルト）
  • label：薬剤ラベル情報
  • adverse_events：有害事象報告

レスポンス例：

{
  "status": "success",
  "results": {
    "drug_info": [
      {
        "brand_name": "阿司匹林",
        "generic_name": "aspirin",
        "approval_date": "2010-05-18",
        "active_ingredients": ["乙酰水杨酸"]
      }
    ]
  }
}

PubMed検索

GET /pubmed/search?query={query}&max_results={max_results}&date_range={date_range}

パラメータ：

• query：文献検索のキーワード
• max_results：返される最大結果数（デフォルト5）
• date_range：返される記事の公開日範囲を制限する（例：'5'は過去5年）

健康トピック

GET /health_topics/{topic}?language={language}

パラメータ：

• topic：健康トピックのキーワード
• language：コンテンツの言語（enまたはes、デフォルトはen）

臨床試験検索

GET /clinical_trials/search?condition={condition}&status={status}&max_results={max_results}

パラメータ：

• condition：医学的状態または病名
• status：試験の状態（recruiting、completed、active、not_recruiting、all）
• max_results：返される最大結果数

ICD - 10コード検索

GET /icd10/codes?code={code}&description={description}&max_results={max_results}

パラメータ：

• code：ICD - 10コード（オプション、説明が提供されている場合）
• description：医学的状態の説明（オプション、コードが提供されている場合）
• max_results：返される最大結果数（デフォルト10）

汎用ツール実行

POST /mcp/call-tool

リクエストボディ例：

{
  "name": "fda_drug_lookup",
  "arguments": {
    "drug_name": "阿司匹林",
    "search_type": "general"
  },
  "session_id": "optional-session-id"
}

プログラムAPI

FDA薬剤検索

def fda_drug_lookup(drug_name: str, search_type: str = "general"):
    pass

パラメータ：

• drug_name：検索する薬剤名
• search_type：検索する情報のタイプ
  • general：基本的な薬剤情報（デフォルト）
  • label：薬剤ラベル情報
  • adverse_events：有害事象報告

PubMed検索

def pubmed_search(query: str, max_results: int = 5, date_range: str = None):
    pass

パラメータ：

• query：文献検索のキーワード
• max_results：返される最大結果数（デフォルト5）
• date_range：返される記事の公開日範囲を制限する（例：'5'は過去5年）

健康トピック

def get_health_topics(topic: str, language: str = "en"):
    pass

パラメータ：

• topic：健康トピックのキーワード
• language：コンテンツの言語（デフォルトはen）

臨床試験検索

def search_clinical_trials(condition: str, status: str = "all", max_results: int = None):
    pass

パラメータ：

• condition：医学的状態または病名
• status：試験の状態（デフォルトはall）
  • recruiting
  • completed
  • active
  • not_recruiting
• max_results：返される最大結果数

ICD - 10コード検索

def lookup_icd10_codes(code: str = None, description: str = None, max_results: int = 10):
    pass

パラメータ：

• code：ICD - 10コード（オプション）
• description：医学的状態の説明（オプション）
• max_results：返される最大結果数（デフォルト10）

🔧 技術詳細

すべてのデータは以下の公開リソースから取得されています。

• FDA薬剤データベース
• PubMed文献データベース
• ClinicalTrials.gov臨床試験登録庫
• ICD - 10国際疾病分類基準

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細はLICENSEファイルを参照してください。