Colombia MCP Server

# 🇨🇴 Colombia MCP Server [](https://www.npmjs.com/package/@crexative/colombia-mcp-server) [](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