DoctorVerify — 一个用于核验印度医生的 MCP 服务器

使用国家医学委员会（National Medical Commission）的实时数据，核验声称是印度注册医生的人是否确实为注册医生——同时如实说明哪些是官方数据、哪些没有文档记录、哪些需要人工回退。使用前请先阅读"这里的核验实际是如何工作的"；这是本 README 中最重要的部分。

包含内容

Related MCP server: Eka MCP Server

这里的核验实际是如何工作的

官方注册系统不向第三方提供 API——但要让这一切运转起来，其实并不需要。权威数据源是国家医学委员会的印度医学名册（IMR），公众可通过 nmc.org.in 查询。其搜索页面通过客户端 JavaScript 直接调用一个公开、无需认证的 JSON 端点（nmc.org.in/MCIRest/open/...）来渲染结果——这是通过阅读该页面自身的脚本来发现的，而非猜测。search_doctor_registration、get_doctor_profile 和 check_blacklist 调用的正是这个端点，因此它们返回的是真实的 IMR 数据：注册信息、资格、大学和当前停业状态。

本 README 的早期版本曾声称 nmc.org.in 的 robots.txt 禁止自动访问。经核查后发现这是错误的：该路径下的文件根本不是标准格式的 robots.txt——而是一个配置错误的 Apache 片段，按 User-Agent 屏蔽了一小部分具名 SEO 爬虫（Ahrefs、Majestic、Semrush 等），没有任何通用的 Disallow 指令。服务条款也并未禁止此类访问。正是这一点使得此处的实时核验变得合理，而此前并非如此。

诚实的提醒： 该端点仍然没有官方文档，也不受 NMC 支持。它可能随时改变格式、被限流或消失——背后没有任何 SLA、版本控制或支持合同。请将其视为只读、单次查询的流量，而非批量管道（这些工具刻意限制了结果数量，且从不自动翻页）。registration_lookup_guide 保留在工具集中，正是为了在实时路径失效或结果异常时作为回退方案。

一个值得了解的陷阱： 在调研过程中，nmcn.org.in——与真正的 nmc.org.in 仅一字之差——出现在"核验印度医生"搜索结果的排名中，显示 IMR 风格的搜索内容，尽管它并非由国家医学委员会运营。flag_lookalike_domain 能按名称识别出该域名，并将任何不熟悉的域名标记为"未审核"而非默认为安全。始终建议自己手动输入 nmc.org.in，而不是点击医院、中介或广告中的链接——并且请记住，看起来实时的结果也可能来自虚假网站。

如果你需要大规模自动化核验——例如为健康科技平台批量接入医生，而非逐个手动核验——还有两条途径，两者都是官方认可的（不同于上述端点），且都比周末项目要复杂得多：

1. Ayushman Bharat 数字使命（ABDM），医疗专业人员注册系统（HPR）。 政府官方的医生数字身份系统，提供真正的、有文档记录的 OAuth2 API 和位于 sandbox.abdm.gov.in 的沙箱环境。它面向的是作为认证健康系统集成（M1 模块）一部分的从业者注册和确认，而非匿名单次查询，因此接入是一个真正的集成项目——客户端 ID/密钥、认证、一应俱全。

2. 商业 KYC/核验供应商（如 Surepass、IDfy）。多家公司以付费、受支持的 API 产品形式转售 NMC 支持的医生核验服务。对于生产环境来说，这可能是务实之选，但请自行评估每家供应商的实际数据来源、时效性和条款——本项目不推荐任何特定供应商。

环境搭建

需要 Python 3.10+ 和 uv。

./setup.sh

这是一个标准的可安装包（src/doctor_verify_mcp/、pyproject.toml），而非松散的脚本。./setup.sh 运行 uv sync，它会创建 .venv（通过 .python-version 固定为 Python 3.10）并以可编辑模式安装该包及其 dev 依赖组（pytest）。如果没有 uv，请使用 python3 -m venv .venv && source .venv/bin/activate && pip install -e '.[dev]' （如果你的 pip 版本尚不支持依赖组，请添加一个从 [dependency-groups] 到 [project.optional-dependencies] 的镜像）。

运行

uv run mcp dev src/doctor_verify_mcp/server.py

打开它打印的 Inspector URL。尝试仅用姓名调用 search_doctor_registration，然后用注册号或 state_council 缩小范围。从结果中取一个 doctor_id 传给 get_doctor_profile。尝试不带参数调用 check_blacklist 查看当前完整名单。分别用 nmcn.org.in 和 nmc.org.in 尝试 flag_lookalike_domain 并比较结果。查看 doctor-verification://official-sources 资源以获取完整信息。

安装后（可编辑模式或从构建的 wheel 安装），该包还提供一个控制台脚本，可通过 stdio 直接运行服务器（无需 Inspector，用于接入真实主机）：uv run doctor-verify-mcp。

构建

uv build

生成 dist/doctor_verify_mcp-<version>-py3-none-any.whl 和对应的 .tar.gz 源码包，可通过 pip install dist/doctor_verify_mcp-*.whl 在任何地方安装。

测试

uv run pytest

三个实时工具的测试使用开发期间捕获的 NMC 真实响应格式模拟了 HTTP 层（doctor_verify_mcp.server._http_client），因此测试套件不会在每次运行时都访问 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 结构——如需提醒，请参阅上一个项目的 README 获取确切的 JSON。

扩展此项目

• 一旦你了解了所在邦委员会实际使用的注册号格式，添加一个校验注册号格式的工具——各邦差异很大，因此本项目不做猜测。

• 遇到新的仿冒域名时，向 KNOWN_LOOKALIKES 添加更多条目。

• 如果 MCIRest 端点将来改变格式或开始阻止自动化流量，实时工具会抛出明确错误并指向 registration_lookup_guide，而不是静默失败——在断定医生不存在之前，请先检查那里。

• 如果走 ABDM/HPR 路线，一个调用真实、有文档记录的 API（使用你自己的客户端凭据，切勿硬编码在源码中）的 verify_hpr_id 工具，将为你提供一个受支持的替代方案，替代本项目目前使用的无文档端点。

• 为每个邦医学委员会添加带直接链接的资源，用于 IMR 未显示结果、需要直接查询特定邦委员会网站的情况。