瑜伽课程搜索工具

一款用于搜索和筛选全球Isha瑜伽课程的工具,支持按地点、兴趣和类别进行查询。

  • by SivaKorni3086
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 SivaKorni3086/mcps

使用说明

示例使用和测试

本文档提供了测试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进行测试:

  1. 提出会话问题
  2. 跟进改进
  3. 请求多个相关搜索
  4. 整合来自多个工具的信息

对话流程示例:

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