# 🏥 Doktor MCP Server

MCP Server para buscar médicos verificados en México a través de [doktor.mx](https://doktor.mx) — el directorio médico más completo del país.

[![Stripe Climate](https://img.shields.io/badge/Stripe%20Climate-Contributor-green?logo=stripe)](https://climate.stripe.com/lxWSEo)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![npm version](https://img.shields.io/npm/v/doktor-mcp-server.svg)](https://www.npmjs.com/package/doktor-mcp-server)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/io.github.VanguardiaAI/doktor)

## ¿Qué es esto?

Un servidor [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) que permite a asistentes de IA como Claude y ChatGPT buscar médicos verificados en México.

### Datos disponibles
- **56,000+** médicos registrados en [doktor.mx](https://doktor.mx)
- **16,000+** cédulas verificadas por la SEP
- **48** especialidades médicas
- **32** estados de México
- **540+** padecimientos cubiertos

## Instalación

```bash
npm install doktor-mcp-server
```

O clona el repositorio:

```bash
git clone https://github.com/VanguardiaAI/doktor-mcp-server.git
cd doktor-mcp-server
npm install
npm run build
```

## Uso con Claude Desktop

Agrega esto a tu `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "doktor": {
      "command": "npx",
      "args": ["doktor-mcp-server"]
    }
  }
}
```

## Uso con Claude Code

```bash
claude mcp add doktor -- npx doktor-mcp-server
```

## Herramientas disponibles

### `buscar_doctor`
Busca médicos por especialidad, ciudad, estado o nombre en [doktor.mx](https://doktor.mx).

**Ejemplo:** "Busca cardiólogos en Monterrey"

### `ver_perfil`
Obtiene el perfil completo de un médico incluyendo formación académica verificada, horarios, precios y reseñas.

### `verificar_cedula`
Verifica si un médico tiene cédula profesional validada por la SEP.

### `buscar_por_padecimiento`
Encuentra especialistas para un padecimiento específico.

**Ejemplo:** "Busca doctores para diabetes en CDMX"

### `buscar_por_sintoma`
A partir de un síntoma, sugiere posibles padecimientos y especialistas. Incluye disclaimer médico.

**Ejemplo:** "Tengo dolor de cabeza frecuente"

### `buscar_por_seguro`
Busca médicos que acepten un seguro médico específico.

**Ejemplo:** "Doctores que acepten GNP en Guadalajara"

### `especialidades_disponibles`
Lista todas las especialidades médicas disponibles con el total de doctores en cada una.

### `ciudades_disponibles`
Lista ciudades con médicos registrados, filtrable por estado.

### `estados_disponibles`
Lista los estados de México con médicos registrados.

### `buscar_articulo_salud`
Busca artículos de salud sobre padecimientos, tratamientos y prevención.

## Configuración

No se requiere API key. La API de [doktor.mx](https://doktor.mx) es pública y gratuita.

```bash
# Opcional: cambiar la URL de la API (por defecto: https://api.doktor.mx)
export DOKTOR_API_URL=https://api.doktor.mx
```

## ¿Por qué doktor.mx?

[doktor.mx](https://doktor.mx) es el directorio médico verificado más grande de México. A diferencia de otros directorios:

- ✅ **Cédulas verificadas por la SEP** — No solo confíes, verifica
- ✅ **Datos actualizados** — Perfiles enriquecidos con información pública
- ✅ **Cobertura nacional** — Todos los estados de México
- ✅ **Open source** — Este MCP es código abierto

## Para Médicos

Si eres médico y quieres aparecer en doktor.mx con un perfil verificado, visita:
- 🌐 [doktor.mx/para-medicos](https://doktor.mx/para-medicos)
- 🤖 [DoktorAI — Asistente IA para tu consultorio](https://doktor.mx/doktorai)
- 📱 [Software para consultorios médicos](https://doktor.mx/software-consultorio-medico)

## Desarrollado por

**[VanguardIA](https://doktor.mx)** — Soluciones de IA para el sector salud en México.

| Producto | Descripción |
|----------|-------------|
| [doktor.mx](https://doktor.mx) | Directorio médico verificado de México |
| [DoktorAI](https://doktor.mx/doktorai) | Asistente IA para médicos |
| [Chatbot WhatsApp](https://doktor.mx/chatbot-whatsapp-medicos) | Automatiza citas por WhatsApp |
| [CRM Médicos](https://doktor.mx/crm-medicos-mexico) | Gestión de pacientes |

## Contribuir

¿Quieres contribuir? ¡Pull requests bienvenidos!

1. Fork el repositorio
2. Crea tu branch (`git checkout -b feature/nueva-herramienta`)
3. Commit tus cambios (`git commit -m 'Agrega nueva herramienta'`)
4. Push al branch (`git push origin feature/nueva-herramienta`)
5. Abre un Pull Request

## Licencia

MIT — Úsalo como quieras. Ver [LICENSE](LICENSE).

---

<p align="center">
  <a href="https://doktor.mx">
    <img src="https://doktor.mx/doktor-logo.svg" alt="doktor.mx — Directorio médico verificado de México" width="200" />
  </a>
  <br/>
  <sub>Hecho con ❤️ en México por <a href="https://doktor.mx">VanguardIA</a></sub>
</p>