# 🇨🇴 Colombia MCP Server

[![NPM Version](https://img.shields.io/npm/v/@crexative/colombia-mcp-server)](https://www.npmjs.com/package/@crexative/colombia-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Un servidor MCP (Model Context Protocol) para consultar información geográfica, turística, histórica y cultural de Colombia.

## 📋 Características

- **15 herramientas** para consultar datos de Colombia
- **Regiones**: Las 6 regiones naturales
- **Departamentos**: 32 departamentos + Bogotá D.C.
- **Ciudades**: Municipios por departamento
- **Turismo**: Atracciones turísticas con coordenadas e imágenes
- **Historia**: Presidentes de Colombia
- **Infraestructura**: Aeropuertos y emisoras de radio
- **Naturaleza**: Áreas naturales protegidas y resguardos indígenas
- **Mapas**: Mapas de departamentos

## 🚀 Instalación

### Para Claude Desktop

Agrega lo siguiente a tu archivo de configuración:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}
```

### Para Cursor

Agrega a `.cursor/mcp.json` en tu proyecto:

```json
{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}
```

### Para Windsurf

Agrega a `~/.windsurf/mcp.json`:

```json
{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}
```

### Para Claude Code (CLI)

Agrega a `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}
```

### Para Cline (VS Code)

En VS Code Settings (JSON):

```json
{
  "cline.mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}
```

---

## 🛠️ Herramientas Disponibles (15)

### 📍 Geografía

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `get_regions` | Obtiene las 6 regiones naturales de Colombia | - |
| `get_departments` | Lista los 32 departamentos + Bogotá D.C. | - |
| `get_department` | Información detallada de un departamento | `id` o `name` |
| `get_departments_by_region` | Departamentos de una región específica | `region_id` (1-6) |
| `get_cities` | Ciudades/municipios de un departamento | `department_id` |

### 🏖️ Turismo

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `get_tourist_attractions` | Atracciones turísticas con coordenadas e imágenes | `city_id` o `search` |
| `get_natural_areas` | Áreas naturales protegidas (parques, reservas) | `department_id` (opcional) |
| `get_maps` | Mapas de departamentos | `department_id` (opcional) |

### 🏛️ Historia y Gobierno

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `get_country_info` | Información general de Colombia (bandera, himno, símbolos) | - |
| `get_presidents` | Lista de todos los presidentes de Colombia | - |
| `get_president` | Información detallada de un presidente | `id` |

### 🏗️ Infraestructura

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `get_airports` | Aeropuertos con códigos IATA/OACI | `department_id` (opcional) |
| `get_radios` | Emisoras de radio con frecuencia y streaming | `city_id` (opcional) |

### 🌿 Cultura y Naturaleza

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `get_indigenous_reservations` | Resguardos indígenas | `department_id` (opcional) |
| `search_colombia` | Búsqueda general de información | `query` |

---

## 🗺️ IDs de Regiones

| ID | Región |
|----|--------|
| 1 | Caribe |
| 2 | Pacífico |
| 3 | Orinoquía |
| 4 | Amazonía |
| 5 | Andina |
| 6 | Insular |

---

## 📝 Ejemplos de Uso

### Geografía
```
Usuario: ¿Cuáles son las regiones de Colombia?
Claude: [Usa get_regions]

Usuario: Dame información sobre Antioquia
Claude: [Usa get_department con name="Antioquia"]

Usuario: ¿Qué departamentos están en la región Caribe?
Claude: [Usa get_departments_by_region con region_id=1]

Usuario: ¿Qué ciudades hay en el Valle del Cauca?
Claude: [Usa get_cities con department_id=31]
```

### Turismo
```
Usuario: ¿Qué lugares turísticos hay en Cartagena?
Claude: [Usa get_tourist_attractions con search="Cartagena"]

Usuario: Busca playas en Colombia
Claude: [Usa get_tourist_attractions con search="playa"]

Usuario: ¿Cuáles son los parques naturales del Amazonas?
Claude: [Usa get_natural_areas con department_id=1]
```

### Historia
```
Usuario: ¿Quiénes han sido los presidentes de Colombia?
Claude: [Usa get_presidents]

Usuario: Dame información sobre el presidente con ID 10
Claude: [Usa get_president con id=10]
```

### Infraestructura
```
Usuario: ¿Cuáles son los aeropuertos de Colombia?
Claude: [Usa get_airports]

Usuario: Aeropuertos en Antioquia
Claude: [Usa get_airports con department_id=2]

Usuario: ¿Qué emisoras de radio hay en Bogotá?
Claude: [Usa get_radios con city_id=167]
```

### Información General
```
Usuario: ¿Cuál es la capital de Colombia?
Claude: [Usa get_country_info]

Usuario: ¿Cuáles son los símbolos patrios de Colombia?
Claude: [Usa get_country_info]

Usuario: ¿Qué resguardos indígenas hay en el Cauca?
Claude: [Usa get_indigenous_reservations con department_id=11]
```

---

## 🔧 Desarrollo Local

```bash
# Clonar el repositorio
git clone https://github.com/crexative/colombia-mcp-server.git
cd colombia-mcp-server

# Instalar dependencias
npm install

# Compilar
npm run build

# Ejecutar
npm start
```

---

## 🌐 API Utilizada

Este MCP utiliza la [API Colombia](https://api-colombia.com/) para obtener datos actualizados sobre:
- Información del país
- Regiones naturales
- Departamentos y ciudades
- Presidentes
- Aeropuertos
- Emisoras de radio
- Atracciones turísticas
- Áreas naturales protegidas
- Resguardos indígenas
- Mapas

---

## 📄 Licencia

MIT License - ver [LICENSE](LICENSE) para más detalles.

---

## 🤝 Contribuciones

¡Las contribuciones son bienvenidas! Por favor, abre un issue o pull request.

---

## 📧 Contacto

- **Autor**: crexative
- **GitHub**: [@crexative](https://github.com/crexative)
- **NPM**: [@crexative/colombia-mcp-server](https://www.npmjs.com/package/@crexative/colombia-mcp-server)

---

## 🇨🇴 Hecho con ❤️ para Colombia