MoleCare MCP Server

Model Context Protocol (MCP) сервер, который предоставляет Claude и другим MCP-клиентам доступ к:

1. База знаний по дерматологии — обучение по правилу ABCDE, помощники SNOMED CT / ICD-10, подсказки по факторам риска

2. Инструменты MoleCare API (опционально) — родинки, динамика, анализ (ваш бэкенд + API-ключ)

3. Опциональные MLOps / операционные инструменты — проверки работоспособности, MLflow, feature store, инфраструктура (сначала mock-режим)

Это не медицинское устройство. Результаты предназначены только для образовательных и операционных целей. Не используйте их для диагностики или принятия решений о лечении.

Сайт продукта: molecare.co.uk · Приложение: iOS · Android

Зачем это нужно

MoleCare помогает людям отслеживать родинки со временем и готовиться к визитам к специалисту. Этот MCP-сервер позволяет разработчикам и операторам:

• Получать знания по уходу за кожей через Claude Desktop / Cursor

• Прототипировать сценарии ассистента поверх API, совместимого с MoleCare

• Исследовать MLOps-инструменты с безопасными mock-данными, если не заданы учётные данные

Related MCP server: opentargets-mcp

Быстрый старт

Никаких учётных данных, базы данных или облачного аккаунта. Добавьте это в конфигурацию вашего MCP-клиента и перезапустите его:

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

Для Claude Desktop на macOS этот файл находится в ~/Library/Application Support/Claude/claude_desktop_config.json.

Инструменты дерматологических знаний работают сразу — они читают базу знаний, встроенную в пакет. Всё, что обращается к бэкенду, возвращает явно помеченные mock-данные, пока вы это не настроите; так что вы можете изучить все инструменты, прежде чем решить, нужны ли они вам.

Чтобы проверить работу вообще без клиента:

npx -y molecare-mcp

Он запускается и ждёт ввода через stdio. Отсутствие вывода означает, что он работает.

Подключение реального бэкенда

Понадобится только в том случае, если вы запускаете API, совместимый с MoleCare:

{
  "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/* — критерии ABCDFI, типы кожи по Фицпатрику, профилактика, когда следует обратиться и к дерматологу, ссылки на SNOMED CT и ICD-10.

Данные продукта MoleCare — требуется API

Возвращает помеченные mock-данные до тех пор, пока не задана MOLECARE_API_URL.

Они существуют, потому что MoleCare управляет этим стеком через ассистента. Вне этого контекста они бесполезны, и все они возвращают mock-данные, пока не настроен соответствующий бэкенд.

Для работы AWS-инструментов нужны пакеты @aws-sdk/client-ec2 и @aws-sdk/client-cloudwatch. Это необязательные peer-зависимости — они не устанавливаются по умолчанию, потому что добавляют 33 МБ, которые не должен скачивать тот, кому нужны только дерматологические инструменты. Установите их, если хотите работать с реальными данными 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 только если вы подключите их к реальному «бэндэ» с реальной аутентификацией — считайте это продакшеном

• Ограничение скорости и аутентификация должны быть на вашем API, а не только на MCP-процессе

Медицинское предупреждение

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 -rhoE "process\.env\.[A-Z_0-9]+" src/. ONTOLOGY_API_URL и FEAST_REPO_PATH не читаются ни одним исходным файлом.

• Model Context Protocol

• MoleCare

• MoleCare-ML — сервис классификации меланоны и обучающие блокноты

Лицензия

Apache-2.0 © MoleCare LTD