使用说明
🇨🇴 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
