kyoto-assistant-mcp
Uses Google Gemini 2.0 Flash as the underlying LLM for processing user requests.
Integrates LangChain v1.0 as the framework for building the agent and tool interactions.
Integrates LangGraph v1.0 for managing the agent's workflow using StateGraph.
Fetches real attraction data for Kyoto from Wikivoyage API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kyoto-assistant-mcpplan a 2-day Kyoto itinerary with temples and gardens"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
京都旅遊助理 (Kyoto Travel Assistant)
版本: v4.1 (LangChain v1.0 + LangGraph v1.0)
風格: 完全仿照維也納旅遊助理
🎯 專案特色
✅ Wikivoyage API - 真實景點資料
✅ 營業檢查工具 - 模擬版本(可升級 Google Places)
✅ ReAct 策略 - Think → Act → Observe
✅ Planning 策略 - 動態調整行程
✅ LangChain v1.0 - 最新穩定 API
✅ LangGraph v1.0 - StateGraph 工作流
✅ 7 個 MCP 工具 - 完整協同
✅ Claude Desktop - 可重用 MCP Server
Related MCP server: wanderlog-mcp
🚀 快速開始
1. 環境設置
# 建立虛擬環境
python -m venv venv
source venv/bin/activate # macOS/Linux
# 安裝套件
pip install -r requirements.txt2. 設定 API Keys
# 複製環境變數模板
cp .env.example .env
# 編輯 .env,填入你的 API Keys3. 測試運行
# 測試 MCP Server(稍後實現)
python mcp_server/server.py
# 測試 CLI(稍後實現)
python main.py test📂 專案結構
kyoto-assistant/
├── src/ # Agent 相關
│ ├── agent/ # LangChain v1.0 Agent
│ ├── workflow/ # LangGraph v1.0 Workflow
│ └── cli/ # CLI 介面
├── mcp_server/ # MCP Server
│ └── tools/ # 7 個 MCP 工具
├── data/ # 資料檔案
├── output/ # 輸出檔案
└── tests/ # 測試腳本🔧 技術棧
LLM: Google Gemini 2.0 Flash (免費)
框架: LangChain 1.0.x + LangGraph 1.0.x
MCP: Model Context Protocol 1.3.2
Python: 3.10+
📚 使用範例
# 規劃行程
python main.py plan --days 2 --budget 25000 --interests 寺廟
# 詢問問題
python main.py ask "清水寺現在營業嗎?"
# 互動模式
python main.py interactive🎓 學習目標
✅ Wikivoyage API 整合
✅ LangChain v1.0 API
✅ LangGraph v1.0 StateGraph
✅ MCP Server 開發
✅ ReAct + Planning 策略
開發中... 🚧
This server cannot be deployed
Maintenance
Related MCP Connectors
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Travel notebook your AI agent writes from your photos and remarks over MCP.
- WauldoOAuthcom.wauldo
Stateless agentic tools over MCP: concept extraction, long-context, knowledge graph, planning.
- TravolpOAuthcom.travolp
Travel planner: create, edit, and explore trip itineraries from your Travolp AI assistant.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. It exposes specialized agents for weather data and trip planning to any MCP-compliant client.-
- AlicenseAqualityAmaintenanceWanderlog-mcp is an MCP server that lets LLM agents plan and edit Wanderlog trip itineraries — adding places, hotels, notes, and checklists to any day, managing trip dates, and searching for destinations. It turns a conversational prompt into a fully built-out travel itinerary with practical details interleaved between each stop.18170 npm132MIT
- FlicenseNot gradedqualityDmaintenanceEnables travel planning through natural language, providing weather forecasts, attraction search, itinerary generation, and distance calculations using free APIs.-
- FlicenseNot gradedqualityCmaintenanceEnables travel-related queries and planning including weather, train and flight information, itinerary generation, and travel knowledge retrieval via RAG, using an AI agent with MCP protocol.-