A Model Context Protocol (MCP) server providing access to Paraguay's tourist places with advanced location-based search capabilities.
- 🗺️ Complete tourist places database
- 📍 Location-based search with distance calculations
- 🌐 Automatic IP-based geolocation
- 🔍 Geocoding support (city/address to coordinates)
- 🎯 Results sorted by distance
- 🏗️ Clean architecture following SOLID principles
# Clone repository
git clone https://github.com/yourusername/paraguay-tourism-MCP-Server.git
cd paraguay-tourism-MCP-Server
# Setup virtual environment
python3.11 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Run server
python src/paraguay_tourism/server.py- 📖 Installation Guide - Setup and configuration
- 🏗️ Architecture - Project structure and design
- 🛠️ API Reference - Complete MCP tools documentation
- 📍 Location Usage - Location-based features guide
- 🤝 Contributing - Contribution guidelines
- 📝 CHANGELOG - Version history
| Tool | Description |
|---|---|
list_all_tourist_places |
List all tourist places |
get_tourist_place_by_id |
Get place details by ID |
find_tourist_places_by_distance |
Search by distance from coordinates |
get_current_location |
Get location via IP |
geocode_location |
Convert address to coordinates |
find_nearby_tourist_places |
Auto-location + nearby search |
See API Reference for complete documentation.
- Python 3.11+
- FastMCP - MCP server framework
- Pydantic - Data validation
- httpx - HTTP client
- tabulate - Table formatting
Licensed under GNU General Public License v3.0 - see LICENSE file.
Made with ❤️ for Paraguay Tourism