🇨🇴 Colombia MCP Server

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

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

Para Cursor

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

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

Para Windsurf

Agrega a ~/.windsurf/mcp.json:

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

Para Claude Code (CLI)

Agrega a ~/.claude/settings.json:

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

Para Cline (VS Code)

En VS Code Settings (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

# 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 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 para más detalles.

🤝 Contribuciones

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

📧 Contacto

• Autor: crexative
• GitHub: @crexative
• NPM: @crexative/colombia-mcp-server

🇨🇴 Hecho con ❤️ para Colombia