MoleCare MCP Server

Model Context Protocol(MCP) 서버로, Claude와 다른 MCP 클라이언트가 다음에 접근할 수 있게 해 줍니다.

1. 피부과 지식 — ABCDE 교육, SNOMED CT / ICD-10 도우미, 위험 요인 프롬프트

2. 선택적 MoleCare API 도구 — 점(모반), 변화 추이, 분석 (자체 백엔드 + API 키)

3. 선택적 MLOps / 운영 도구 — 상태 점검, 모니터링, 피처 스토어, 인프라(mock-first)

의료 기기가 아닙니다. 출력물은 교육 및 운영 보조 목적으로만 제공됩니다. 진단이나 치료 결정에 사용하지 마세요.

제품 사이트: molecare.co.uk · 앱: iOS · Android

존재 이유

MoleCare는 사람들이 시간이 지나면서 점(모반)을 추적하고 진료 방문을 준비하도록 돕습니다. 이 MCP 서버를 통해 개발자와 운영자는 다음을 할 수 있습니다:

• Claude Desktop / Cursor에서 교육용 피부 건강 지식 검색

• MoleCare 호환 API를 대상으로 어시스턴트 흐름 프로토타이핑

• 자격 증명이 없을 때 안전한 mock 데이터로 MLOps 도구 살펴보기

Related MCP server: opentargets-mcp

빠른 시작

자격 증명도, 데이터베이스도, 클라우드 계정도 필요 없습니다. MCP 클라이언트 설정에 다음을 추가하고 다시 시작하세요.

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"]
    }
  }
}

macOS의 Claude Desktop에서는 이 파일이 ~/Library/Application Support/Claude/claude_desktop_config.json입니다.

피부과 지식 도구는 패키지에 포함된 지식 베이스를 읽기 때문에 즉시 작동합니다. 백엔드와 통신하는 모든 도구는 설정을 완료하기 전까지 명확하게 표시된 mock 데이터를 반환하므로, 전체 도구를 먼저 살펴보고 필요한 것만 선택할 수 있습니다.

클라이언트 없이 시도하려면:

npx -y molecare-mcp

stdio에서 시작되어 대기하고, 출력이 없으면 정상적으로 동작 중이라는 뜻입니다.

실제 백엔드 연결

MoleCare 호환 API를 실행 중인 경우에만 필요합니다.

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"],
      "env": {
        "MOLECARE_API_URL": "http://localhost:8080/api",
        "MOLECARE_API_KEY": "your-local-api-key"
      }
    }
  }
}

localhost(또는 자체 배포 환경)를 사용하세요. 클라우드 드라이브에 동기화되는 설정 파일에 프로덕션 키를 붙여넣지 마세요.

환경 변수

실시간 백엔드를 원하지 않는 한 모두 선택 사항입니다.

.env.example를 참고하세요.

도구

피부과 지식 — 설정 불필요

이 도구들이 대부분의 사용자가 이 패키지를 설치하는 이유입니다. 패키지에 포함된 지식 베이스에서 제공되며 API, 키, 네트워크가 전혀 필요 없습니다.

리소스: molecare://knowledge/* — ABCDE 진단 기준, Fitzpatrick 피부 유형, 예방, 피부과 진료가 필요한 시기, SNOMED CT 및 ICD-10 참조 자료.

MoleCare 제품 데이터 — API 필요

MOLECARE_API_URL이 설정될 때까지 라벨이 있는 mock 데이터를 반환합니다.

이 도구들은 MoleCare가 어시스턴트를 통해 이 스택을 운영하기 때문에 존재합니다. 해당 맥락 밖에서 사용될 일이 거의 없으며, 해당 백엔드가 설정되지 않은 상태에서는 모두 mock 데이터를 반환합니다.

AWS 도구는 선택적 peer dependencies인 @aws-sdk/client-ec2와 @aws-sdk/client-cloudwatch가 필요합니다. 이 둘은 기본 설치 시 포함되지 않습니다. 피부과 도구만 필요한 사용자가 불필요하게 33MB를 다운로드하지 않도록 하기 위해서 입니다. 실제 AWS 데이터를 사용하려면 직접 설치하세요.

npm i @aws-sdk/client-ec2 @aws-sdk/client-cloudwatch

아키텍처

Claude / Cursor / MCP client
        │ stdio (JSON-RPC)
        ▼
  molecare-mcp
   ├─ medical KB (local)
   ├─ MoleCare API client (optional)
   ├─ ontology / MLflow / Feast clients (optional)
   └─ AWS / CI clients (optional, mock if unset)
        │
        └─ optional HTTP GET /health  (Docker / ECS)

Docker

docker build -t molecare-mcp .
docker run --rm -p 3000:3000 molecare-mcp
curl http://localhost:3000/health

보안

• .env 파일이나 API 키를 절대 커밋하지 마세요 — 취약점 신고는 SECURITY.md를 참고하세요

• 데모와 스크린샷에는 mock 모드를 권장합니다

• userId를 받는 도구는 실제 인증이 있는 실제 백엔드에 연결한 경우에만 PHI를 반환할 수 있습니다. 그러한 환경은 프로덕션으로 취급하세요

• 속도 제한과 인증은 MCP 프로세스에서만 하는 것이 아니라 자체 API에서 적용하세요

의료 면책 안내

MoleCare MCP는 교육용 정보와 개발자 도구를 제공합니다. 피부암(흑색종)이나 어떤 질병들도 진단하지 않습니다. 의학적 문의가 있다면 반드시 경력있는 임상의와 상담하세요.

개발

git clone https://github.com/MoleCare/molecare-mcp.git
cd molecare-mcp
npm install
npm run build
npm run dev      # auto-reload
npm run inspect  # browse tools in MCP Inspector

기여는 환영입니다. 먼저 CONTRIBUTING.md를 읽어 주세요 — mock-first 규칙, 의료 콘텐츠와 관련된 임상 안전 경계, 그리고 good first issue를 찾는 방법을 확인할 수 있습니다.

비밀 정보는 예제에서 제외하고, 가급적 localhost 기본값을 사용해 주세요.

관련 링크

환경 변수: .env.example이 공식적인 목록입니다(소스가 읽는 전체 27개 변수). 정확한 정보는 grep -rhaoE "process\.env\.[A-Z_0-9]+" src/로 재생성할 수 있습니다. ONTOLOGY_API_URL과 FEAST_REPO_PATH는 소스 파일에서 읽지 않습니다.

• Model Context Protocol

• MoleCare

• MoleCare-ML — 흑색종 분류 서비스 및 학습 노트

라이선스

Apache-2.0 © MoleCare LTD