med-lit-mcp

의료진의 "조사" 시간을 줄이기 위한 MCP 서버입니다. PubMed·임상시험·의약품 정보·진료 가이드라인·진료보수 마스터를 Claude에서 직접 조회할 수 있게 합니다.

미국의 조사에 따르면 의사는 진료 1시간당 1.5~2시간을 사무와 기록에 사용합니다. 그중 일부가 문헌·첨부문서·제도 확인입니다. 이 서버는 바로 그 점을 노리고 있습니다.

이 서버가 하지 않는 일

본 소프트웨어는 의료기기 프로그램(SaMD)이 아닙니다. 약사법상 해당성은 '기여도(의학적 판단에 미치는 영향의 크기)'와 '위험(오작동 시 위해)'으로 판단됩니다. 본 서버는 1차 정보의 소재를 안내할 뿐 의학적 판단을 수행하지 않으므로 비해당 범위에 머뭅니다.

설계상 다음은 하지 않습니다.

• 진단명 제시·감별진단 나열

• 치료 방침·약제 선택·투여량 권고

• 검사 수치나 영상에서의 소견 판정

• 초록이나 첨부문서의 요약·바꿔 쓰기(원문 그대로 반환)

반환하는 것은 출처와 원문뿐입니다. 판단은 의료진이 하십시오.

이 방침은 코드로 보장하고 있습니다. src/med_lit_mcp/guard.py에 금지 표현 패턴을 두고, 서버가 스스로 생성하는 문구(도구 설명·주석·오류 메시지)에 판단을 시사하는 표현이 섞여 있지 않은지 테스트로 검사하고 있습니다.

다루는 데이터

환자의 개인정보는 일절 다루지 않습니다. 외부로 전송하는 것은 검색 키워드뿐입니다. 통신 대상은 다음 4개 호스트로 제한되며, 그 외의 통신은 예외를 던집니다(http.py의 ALLOWED_HOSTS).

조회 결과는 로컬 SQLite에 캐시됩니다(기본값 ~/.cache/med-lit-mcp/). 진료보수 마스터를 가져오면 해당 검색은 네트워크 없이 동작합니다.

설치

uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

또는 clone 후:

git clone https://github.com/fc0web/med-lit-mcp
cd med-lit-mcp
uv sync
uv run med-lit-mcp

Claude Desktop / Claude Code에 등록

claude_desktop_config.json（Claude Desktop）또는 .mcp.json（Claude Code）에 추가합니다.

{
  "mcpServers": {
    "med-lit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fc0web/med-lit-mcp", "med-lit-mcp"],
      "env": {
        "NCBI_EMAIL": "you@example.com"
      }
    }
  }
}

Claude Code라면 한 줄로 등록할 수 있습니다.

claude mcp add med-lit -- uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

도구

사용 예

「オルフォルグリプロンの第3相試験を、2025年以降のRCTに絞って探して」
  → search_pubmed(term="orforglipron", year_from=2025, study_types=["rct"])

「初診料の点数を調べて」
  → import_shinryo_master(kind="shinryo")   # 初回のみ
  → search_shinryo_hoshu(term="初診料")

설정(환경 변수)

API 키가 없어도 동작합니다. 속도 제한은 초과 시 예외가 아닌 대기와 재시도로 처리합니다.

사내 프록시·자체 CA를 사용하는 경우

MCP 클라이언트는 서버를 하위 프로세스로 시작할 때 최소한의 환경 변수만 상속합니다. 기업 네트워크에서 자체 인증 기관을 사용하는 경우 TLS 검증에 실패할 수 있습니다. 설정의 env에 명시하십시오.

"env": {
  "SSL_CERT_FILE": "/path/to/ca-bundle.crt",
  "REQUESTS_CA_BUNDLE": "/path/to/ca-bundle.crt",
  "HTTPS_PROXY": "http://proxy.example.jp:8080"
}

할 수 없는 일(솔직히)

• Minds 가이드라인 라이브러리 본문 검색. Minds는 검색 결과를 브라우저 측에서 렌더링하며 공개 API도 없습니다. 헤드리스 브라우저로 가져오는 것이 기술적으로는 가능하지만, 사양 변경에 취약하고 이용 조건도 명확하지 않아 v0.1에서는 수행하지 않고 검색 URL 제시에 그칩니다.

• PMDA 첨부문서 본문 취득. 마찬가지로 공개 API가 없어 KEGG를 1차 소스로 하고 PMDA 검색 URL을 병기하고 있습니다. 첨부문서의 기재가 정본이며, 실무에서는 반드시 PMDA에서 원문을 확인하십시오.

• 치과·조제 마스터. v0.1은 의과 진료행위·의약품·특정 기재의 3종뿐입니다.

개발

uv sync
uv run pytest              # 外部APIを叩かないテスト
uv run pytest -m live      # 実APIへの疎通テスト
uv run ruff check .

출처

• NCBI E-utilities

• ClinicalTrials.gov API v2

• KEGG REST API

• 진료보수 정보 제공 서비스

• Minds 가이드라인 라이브러리

• PMDA 의약품 검색

라이선스

MIT.

면책

본 소프트웨어는 의료기기 프로그램이 아닙니다. 진단·치료 판단에 사용되는 것이 아니며, 출력의 최종 확인 책임은 이용자에게 있습니다. 제도·점수·약가·가이드라인은 개정되므로 실무에서는 반드시 1차 정보로 확인하십시오.