Colombia MCP Server

Un servidor MCP (Model Context Protocol) para consultar informacin geogrfica y turstica de Colombia.

Caractersticas

• Regiones: Consulta las 6 regiones naturales de Colombia
• Departamentos: Informacin de los 32 departamentos + Bogot D.C.
• Ciudades: Listado de municipios por departamento
• Turismo: Atracciones tursticas con ubicacin e imgenes
• Bsqueda: Bsqueda general de informacin

Instalacin

Para Claude Desktop

Agrega lo siguiente a tu archivo de configuracin:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Para Cursor

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

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

Para Windsurf

Agrega a ~/.windsurf/mcp.json:

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

Para Claude Code (CLI)

Agrega a ~/.claude/settings.json:

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

Para Cline (VS Code)

En VS Code Settings (JSON):

{
  "cline.mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["colombia-mcp-server"]
    }
  }
}

Herramientas Disponibles

get_regions

Obtiene las 6 regiones naturales de Colombia.

get_departments

Lista todos los departamentos de Colombia con su informacin bsica.

get_department

Obtiene informacin detallada de un departamento especfico.

Parmetros:

• id (number, opcional): ID del departamento (1-33)
• name (string, opcional): Nombre del departamento

get_departments_by_region

Obtiene los departamentos de una regin especfica.

Parmetros:

• region_id (number): ID de la regin
  • 1 = Caribe
  • 2 = Pacfico
  • 3 = Orinoqua
  • 4 = Amazona
  • 5 = Andina
  • 6 = Insular

get_cities

Lista las ciudades/municipios de un departamento.

Parmetros:

• department_id (number): ID del departamento

get_tourist_attractions

Busca atracciones tursticas.

Parmetros:

• city_id (number, opcional): ID de la ciudad
• search (string, opcional): Palabra clave para buscar

search_colombia

Bsqueda general de informacin sobre Colombia.

Parmetros:

• query (string): Trmino de bsqueda

Ejemplos de Uso

Usuario: Cules son las regiones de Colombia?
Claude: [Usa get_regions]

Usuario: Dame informacin sobre Antioquia
Claude: [Usa get_department con name="Antioquia"]

Usuario: Qu departamentos estn en la regin 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]

Usuario: Busca lugares tursticos con playas
Claude: [Usa get_tourist_attractions con search="playa"]

Desarrollo Local

# Clonar el repositorio
git clone https://github.com/tu-usuario/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:

• Regiones naturales
• Departamentos
• Ciudades y municipios
• Atracciones tursticas

Licencia

MIT License - ver LICENSE para ms detalles.

Contribuciones

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

Contacto

• GitHub: @tu-usuario
• Issues: github.com/tu-usuario/colombia-mcp-server/issues