使用说明
示例使用和测试
本文档提供了测试Isha Programs MCP服务器的示例查询和预期行为。
工具:search_programs_by_location
基本国家搜索
Query: "Show me yoga programs in India"
Tool Call: search_programs_by_location(country="India", limit=20)
Expected: List of programs in India with details
城市特定搜索
Query: "What programs are available in Bangalore?"
Tool Call: search_programs_by_location(country="India", city="Bangalore", limit=20)
Expected: Programs specifically in Bangalore, India
多个国家
Query: "Show me programs in USA"
Tool Call: search_programs_by_location(country="USA", limit=20)
Expected: List of programs in United States
工具:搜索程序byinterest
具体做法
Query: "I want to learn Surya Kriya"
Tool Call: search_programs_by_interest(interest="surya kriya")
Expected: All Surya Kriya programs globally
类别搜索
Query: "Show me meditation programs"
Tool Call: search_programs_by_interest(interest="meditation")
Expected: All meditation-related programs
带位置过滤器
Query: "Find Inner Engineering programs in USA"
Tool Call: search_programs_by_interest(interest="inner engineering", country="USA")
Expected: Inner Engineering programs in USA only
Kriya项目
Query: "What kriyas can I learn?"
Tool Call: search_programs_by_interest(interest="kriya")
Expected: All kriya-type programs (Shambhavi, Surya Kriya, etc.)
工具:search_programs_nearby
坐标搜索
Query: "Find programs near coordinates 12.9716, 77.5946"
Tool Call: search_programs_nearby(latitude=12.9716, longitude=77.5946)
Expected: Programs near Bangalore, India
用户位置
Query: "What programs are near me?" (with user sharing location)
Tool Call: search_programs_nearby(latitude=USER_LAT, longitude=USER_LON)
Expected: Programs sorted by distance from user
工具:get_program_details
特定程序
Query: "Tell me more about program ID 56924"
Tool Call: get_program_details(program_id="56924")
Expected: Detailed JSON information about that specific program
工具:filter_programs
在线课程
Query: "Show me online programs in India"
Tool Call: filter_programs(country="India", online=true, limit=20)
Expected: Only online programs in India
萨古鲁项目
Query: "Find programs where Sadhguru will be present in USA"
Tool Call: filter_programs(country="USA", with_sadhguru=true)
Expected: Programs in USA featuring Sadhguru
语言过滤器
Query: "Show me Hindi language programs"
Tool Call: filter_programs(country="India", language="hindi")
Expected: Programs conducted in Hindi
组合过滤器
Query: "Find online English programs with Sadhguru"
Tool Call: filter_programs(country="India", online=true, language="english", with_sadhguru=true)
Expected: Programs matching all criteria
工具:获取可用国家
发现
Query: "Which countries have Isha programs?"
Tool Call: get_available_countries()
Expected: Complete list of countries with programs
工具:获取_城市_国家
城市探索
Query: "What cities in India have programs?"
Tool Call: get_cities_in_country(country="India")
Expected: List of Indian cities with programs
Query: "Which cities in USA offer Isha programs?"
Tool Call: get_cities_in_country(country="USA")
Expected: List of US cities with programs
工具:列表_程序_类别
类别发现
Query: "What types of programs are available?"
Tool Call: list_program_categories()
Expected: Complete list of program categories with keywords
复杂的多步查询
计划旅行
User: "I want to attend a yoga retreat in India next month"
Steps:
1. list_program_categories() - Show retreat category
2. search_programs_by_interest(interest="retreat", country="India")
3. User selects a program
4. get_program_details(program_id=SELECTED_ID)
学习路径
User: "I'm new to Isha. What should I start with?"
Steps:
1. list_program_categories() - Show all categories
2. search_programs_by_interest(interest="inner engineering", country=USER_COUNTRY)
3. Explain Inner Engineering as the foundation program
本地发现
User: "I live in Chennai. What can I do this weekend?"
Steps:
1. search_programs_by_location(country="India", city="Chennai", limit=10)
2. Filter results by upcoming weekend dates
3. Present options with registration links
预期数据格式
每个程序结果包括:
**Program Title**
- Category: Angamardana
- Date: 22 - 23 Nov 2025
- Time: 7:30AM - 6:15PM
- Location: Sadhguru Sannidhi, Bengaluru, India
- Fee: INR 3500
- Language: english
- Gender: unspecified
- Online: No
- With Sadhguru: No
- Program URL: https://isha.sadhguru.org/program-details/...
- Register: https://online.sadhguru.org/event-register?event=...
- Program ID: 78206
错误场景
未找到结果
Query: "Programs in Antarctica"
Expected: Graceful message saying no programs found
程序ID无效
Query: "Details for program 999999999"
Expected: Error message about invalid program ID
API速率限制
Expected: Appropriate error message if API rate limit hit
业绩说明
- 典型响应时间:1-3秒
- 大型结果集可能需要更长的时间
- 由于距离计算,坐标搜索可能会变慢
- 考虑设定合理的限制(20-50项)
集成测试
使用Claude Desktop进行测试:
- 提出会话问题
- 跟进改进
- 请求多个相关搜索
- 整合来自多个工具的信息
对话流程示例:
User: "I want to learn yoga"
→ list_program_categories()
User: "Tell me about the Yogasanas programs"
→ search_programs_by_interest(interest="yogasanas")
User: "Which of these are in Bangalore?"
→ filter previous results by location
User: "Tell me more about program #3"
→ get_program_details(program_id=...)
User: "How do I register?"
→ Provide registration URL from program details
