DoctorVerify — MCP-сервер для проверки индийских врачей

Проверяет, действительно ли человек, утверждающий, что он зарегистрированный индийский врач, является таковым, используя живые данные National Medical Commission — при этом честно указывая, что является официальным, что недокументированным, а что ручным запасным вариантом. Прочитайте раздел «Как на самом деле работает проверка здесь» перед использованием; это самая важная часть этого README.

Что здесь

Related MCP server: Eka MCP Server

Как на самом деле работает проверка здесь

Официальный реестр не публикует API для третьих сторон — но для работы этого ему и не нужно. Авторитетным источником является Indian Medical Register (IMR) от National Medical Commission, доступный для публичного поиска на nmc.org.in. Его собственная страница поиска вызывает публичный неаутентифицированный JSON-эндпоинт (nmc.org.in/MCIRest/open/...) напрямую из клиентского JavaScript для отображения результатов — это было обнаружено при чтении скрипта самой страницы, а не угадыванием. search_doctor_registration, get_doctor_profile и check_blacklist вызывают тот же эндпоинт, поэтому возвращают реальные данные IMR: регистрацию, квалификацию, университет и текущий статус отстранения.

Более ранняя версия этого README утверждала, что robots.txt на nmc.org.in запрещает автоматический доступ. Это было проверено и оказалось неверным: файл по этому пути вообще не является robots.txt в стандартном формате — это неправильно настроенный фрагмент Apache, блокирующий короткий список поименованных SEO-краулеров (Ahrefs, Majestic, Semrush, ...) по User-Agent, без общей директивы Disallow. Условия использования этого тоже не запрещают. Именно это изменение сделало живую проверку здесь оправданной, тогда как раньше она таковой не была.

Честное предостережение: этот эндпоинт по-прежнему не документирован и не поддерживается NMC. Он может изменить формат, получить ограничение частоты запросов или исчезнуть без уведомления — за ним нет SLA, версионирования или контракта на поддержку. Относитесь к нему как к трафику только для чтения с одиночными запросами, а не как к конвейеру массовой загрузки (эти инструменты намеренно ограничивают количество результатов и никогда не выполняют автоматическую пагинацию). registration_lookup_guide остаётся в наборе инструментов именно как запасной вариант на случай, если живой путь сломается или результат выглядит неверным.

Реальная ловушка, о которой стоит знать: во время исследования этого проекта nmcn.org.in — на одну букву отличающийся от настоящего nmc.org.in — всплывал в результатах поиска по запросам «проверить индийского врача», показывая контент в стиле IMR, хотя не управляется National Medical Commission. flag_lookalike_domain распознаёт его по имени и помечает всё остальное незнакомое как непроверенное, а не предполагает, что оно безопасно. Всегда предпочитайте самостоятельно вводить nmc.org.in, а не переходить по ссылке из больницы, от агента или из рекламы — и помните, что даже внешне «живой» результат может исходить с поддельного сайта.

Если вам нужна автоматизированная проверка в масштабе — например, онбординг множества врачей в health-tech платформу, а не ручная проверка одного — есть ещё два пути, оба официально одобренные (в отличие от эндпоинта выше), и оба более масштабные, чем проект на выходные:

1. Ayushman Bharat Digital Mission (ABDM), Healthcare Professional Registry (HPR). Собственная государственная система цифровой идентификации врачей с настоящим документированным OAuth2 API и песочницей на sandbox.abdm.gov.in. Она предназначена для регистрации и подтверждения практикующих врачей в рамках аккредитованной интеграции с системой здравоохранения (модуль M1), а не для анонимных разовых запросов, поэтому онбординг — это настоящий интеграционный проект: client ID/secret, сертификация и всё такое.

2. Коммерческие KYC/верификационные провайдеры (например, Surepass, IDfy). Несколько компаний перепродают проверку врачей на основе NMC как платный поддерживаемый API-продукт. Это может быть прагматичным выбором для продакшена, но оцените фактический источник данных, свежесть и условия каждого провайдера самостоятельно — этот проект не поддерживает какой-либо конкретный.

Установка

Требуются Python 3.10+ и uv.

./setup.sh

Это полноценный устанавливаемый пакет (src/doctor_verify_mcp/, pyproject.toml), а не просто отдельный скрипт. ./setup.sh запускает uv sync, который создаёт .venv (закреплённый за Python 3.10 через .python-version) и устанавливает пакет вместе с его группой зависимостей dev (pytest) в режиме editable. Если у вас нет uv, используйте запасной вариант: python3 -m venv .venv && source .venv/bin/activate && pip install -e '.[dev]' (добавьте зеркальное соответствие [dependency-groups] → [project.optional-dependencies], если ваша версия pip ещё не понимает dependency groups).

Запуск

uv run mcp dev src/doctor_verify_mcp/server.py

Откройте URL Inspector, который он выведет. Попробуйте search_doctor_registration только с именем, затем сузьте поиск с помощью регистрационного номера или state_council. Возьмите doctor_id из результатов и передайте его в get_doctor_profile. Попробуйте check_blacklist без аргументов, чтобы увидеть полный текущий список. Попробуйте flag_lookalike_domain с nmcn.org.in и с nmc.org.in и сравните. Проверьте ресурс doctor-verification://official-sources, чтобы увидеть полную картину в одном месте.

После установки (в режиме editable или из собранного wheel) пакет также предоставляет консольный скрипт, который запускает сервер напрямую через stdio (без Inspector, для подключения к реальному хосту): uv run doctor-verify-mcp.

Сборка

uv build

Создаёт dist/doctor_verify_mcp-<version>-py3-none-any.whl и соответствующий .tar.gz sdist, устанавливаемый где угодно с помощью pip install dist/doctor_verify_mcp-*.whl.

Тестирование

uv run pytest

Тесты для трёх живых инструментов мокают HTTP-слой (doctor_verify_mcp.server._http_client) с реальными формами ответов NMC, сохранёнными во время разработки, поэтому набор тестов не обращается к nmc.org.in при каждом запуске.

Подключение к реальному хосту

Создаёте реальную интеграцию (например, встраиваете это в поток регистрации/онбординга врачей)? Смотрите INTEGRATION.md — там полная справочная информация по инструментам, рекомендуемый процесс проверки, контракт обработки ошибок и известные особенности живого эндпоинта.

Та же схема, что и для любого локального MCP-сервера: хост запускает ваш сервер как дочерний процесс через stdio, поэтому каждому хосту нужна одна и та же команда запуска с абсолютным путём. После установки пакета консольный скрипт doctor-verify-mcp — самый чистый вариант запуска вместо того, чтобы указывать хостам на server.py напрямую.

Claude Desktop: выполните uv run mcp install src/doctor_verify_mcp/server.py, затем полностью закройте и снова откройте приложение.

Claude Code:

claude mcp add doctorverify -- uv run --with "mcp[cli]" mcp run /absolute/path/to/src/doctor_verify_mcp/server.py

Cursor (.cursor/mcp.json) и VS Code (.vscode/mcp.json) используют ту же структуру command/args — если нужно напоминание, точный JSON смотрите в README предыдущего проекта.

Расширение проекта

• Добавьте инструмент, который проверяет форму регистрационного номера, когда вы узнаете формат, который фактически использует ваш государственный медицинский совет, — они достаточно различаются между штатами, поэтому этот проект не угадывает единый формат.

• Добавляйте новые записи в KNOWN_LOOKALIKES по мере обнаружения.

• Если эндпоинт MCIRest когда-либо изменит формат или начнёт блокировать автоматический трафик, живые инструменты уже сейчас выбрасывают понятную ошибку, отсылающую к registration_lookup_guide, а не молча падают, — сначала проверяйте там, прежде чем предполагать, что врача не существует.

• Если вы пойдёте по пути ABDM/HPR, инструмент verify_hpr_id, вызывающий настоящий документированный API (с вашими собственными учётными данными клиента, никогда не захардкоженными в исходном коде), даст вам поддерживаемую альтернативу недокументированному эндпоинту, который этот проект использует сегодня.

• Добавьте ресурс для каждого государственного медицинского совета с прямыми ссылками на случаи, когда IMR не показывает результат и запасной вариант — напрямую проверить сайт совета конкретного штата.