How thushi404/agentic-ai-travel-guide works
This is a command-line AI travel assistant. A user enters a travel request; the app sends it through a stateful LangGraph agent, which can dispatch MCP tools and returns a response to the terminal. Its domain capabilities include weather forecasts, nearby-place searches, walking estimates, and itinerary generation. Itinerary generation combines weather and place-search results. The excerpts show the MCP server and tool implementations, but not the adapter’s runtime dispatch internals; that connection is documented by the app’s MCP configuration and tool-loading code.
Main entry points: server.py MCP tool server · graph.py Graph workflow · nodes.py Agent and tools · maps.py Places and walking
Components 14
Conversation
- Chat CLI
travel-agent/app.py - MCP tool server
travel-agent/mcp/server.py
Agent workflow
- Graph workflow
travel-agent/graph/graph.py - Agent and tools
travel-agent/graph/nodes.py - Conversation state
travel-agent/graph/state.py - Travel prompt
travel-agent/prompts.py
Travel capabilities
- Weather lookup
travel-agent/tools/weather.py - Places and walking
travel-agent/tools/maps.py - Itinerary builder
travel-agent/tools/itinerary.py
External services
- API configuration
travel-agent/config.py - OpenAI model
- Geoapify APIs
- Open-Meteo APIs
Other components
- Traveler
Connections 17
- Traveler → Chat CLI: enters request
travel-agent/app.py - Chat CLI → MCP tool server: starts server
travel-agent/app.py - Chat CLI → Graph workflow: builds and invokes
travel-agent/app.py - Graph workflow → Agent and tools: creates nodes
travel-agent/graph/graph.py - Graph workflow → Conversation state: tracks messages
travel-agent/graph/graph.py - Agent and tools → Travel prompt: uses prompt
travel-agent/graph/nodes.py - Agent and tools → API configuration: loads model settings
travel-agent/graph/nodes.py - Agent and tools → OpenAI model: sends messages
travel-agent/graph/nodes.py - MCP tool server → Weather lookup: calls
travel-agent/mcp/server.py - MCP tool server → Places and walking: calls
travel-agent/mcp/server.py - MCP tool server → Itinerary builder: calls
travel-agent/mcp/server.py - Graph workflow → MCP tool server: loads registered tools
- Itinerary builder → Weather lookup: gets forecast
travel-agent/tools/itinerary.py - Itinerary builder → Places and walking: searches places
travel-agent/tools/itinerary.py - Weather lookup → Open-Meteo APIs: geocodes and forecasts
travel-agent/tools/weather.py - Places and walking → API configuration: loads API key
travel-agent/tools/maps.py - Places and walking → Geoapify APIs: geocodes and searches
travel-agent/tools/maps.py