Skip to main content
Glama
README.md
# 🌿 Amazon Rainforest Travel Guide (Claude Agent + MCP)

An AI-powered travel assistant connected to Claude via MCP, designed to help users explore the Amazon Rainforest — from planning routes to discovering nearby hotels and adventure spots.

---

## šŸš€ Features

- šŸŒ Get directions from any location to Manaus, Brazil
- šŸØ Discover nearby hotels using Geoapify
- 🄾 Find adventure spots like hikes and nature trails
- šŸ›ļø Explore food, monuments, and cultural sites
- āš ļø Get essential travel precautions
- šŸ¤– Powered by Claude + FastMCP

---

## šŸ› ļø Tech Stack

- [Claude](https://claude.ai/) (Anthropic Desktop Client)
- [FastMCP](https://github.com/codebasics/FastMCP) for Claude tool registration
- Python + HTTPX + dotenv
- OpenTripMap, Geoapify, OpenRouteService APIs

---

## šŸ“¦ Installation

1. **Clone the repo**:
   ```bash
   git clone https://github.com/Ajey95/MCP.git
   cd MCP
 2. **commands**:
     ```bash
     # On Windows.
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
       uv init projectname
       Create a virtual environment (optional but recommended):
       python -m venv venv
       source venv/bin/activate   # On Windows: venv\Scripts\activate
     
       Add your API keys in a .env file:
       ORS_API_KEY=your_openrouteservice_api_key
       GEOAPIFY_API_KEY=your_geoapify_api_key
       OPENTRIPMAP_API_KEY=your_opentripmap_api_key
 3. **mcp command**:
     ```bash
      install mcp 
      install mcp[cli]
 4. **Final**:
       ```bash
       pip install -r requirements.txt
       To run uv run mcp install file.py
       #Continue building!
---
## 🧠 Connecting Claude to Your MCP Server
Run your server:
  uv run mcp install file.py
Open the Claude desktop app

Click on Add Tool

Paste your MCP endpoint (shown in terminal, e.g., http://localhost:3333/.well-known/ai-plugin.json)

Claude will scan and install tools like:

- get_travel_route

- get_nearby_hotels

- get_adventure_spots

- get_monuments_and_food

- get_precautions

- greet_user
---
šŸ—£ļø Sample Prompts to Try in Claude
  - "What's the distance and travel time from Rio de Janeiro to the Amazon Rainforest?"
  
  - "Find top hotels near Manaus."
  
  - "Suggest some adventure spots near Manaus."
  
  - "What cultural sites can I visit in the Amazon?"
  
  - "Give me precautions before visiting the rainforest."
---
## šŸ¤ Contributing
Pull requests welcome. For major changes, please open an issue first.

## šŸ“„ License
MIT