VenuVidya — Carnatic Flute Study Guide

io.github.pradeep-anantha由 GitHub 帳號 pradeep-anantha 發布v0.1.1更新於 Oct 24, 2026

Kannada/English Carnatic flute KSGMS syllabus — search lessons, log practice, ask a RAG guru.

已驗證Streamable HTTP可網頁執行效率與工作流知識與記憶

概覽

AI 產生的概覽

VenuVidya 讓助理檢索卡納提克長笛教學大綱課程、向附引用的問答機器人提問，並管理個人課堂日誌與練習紀錄。

可以做什麼
  • 依關鍵字、級別或類別搜尋與瀏覽教學大綱課程，並取得單一課程的完整內容
  • 向應用程式內的 RAG 問答機器人提問，取得附引用的有據回答，支援英文或卡納達語
  • 列出你自己的課堂日誌項目，並檢視單一堂課及其項目與練習紀錄
  • 為你擁有的課程中的某個項目記錄一次練習
適用情境
適合學習卡納達語／英文卡納提克長笛 KSGMS 大綱的學生，希望助理協助查詢課程、回答理論與練習問題，並追蹤課堂與練習狀況。
執行需求
遠端 streamable HTTP 端點；未宣告任何套件或環境變數。日誌類工具（list_classes、get_class、log_practice_session）需要個人 VenuVidya mcp_token，須登入應用程式後從其 API 取得。
安裝前請注意
mcp_token 是作為工具參數傳入的個人憑證，應視為機密。log_practice_session 會將練習紀錄寫入你的日誌。日誌工具僅限持有該權杖的帳號範圍。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 VenuVidya — Carnatic Flute Study Guide，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.pradeep-anantha%2Fvenuvidya/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "venuvidya-carnatic-flute-study-guide": {
      "type": "http",
      "url": "https://venuvidya-backend-production.up.railway.app/api/mcp/"
    }
  }
}

工具

7

search_syllabus

Keyword (BM25) search across all Carnatic flute lessons. Args: query: Natural-language question or keywords (English or Kannada). k: Number of top results to return (1-10, default 4). level: Optional filter — 'junior', 'senior' or 'vidwat'.

輸入參數klevelquery必填

get_lesson

Fetch the full study content of a single lesson. Args: lesson_id: Lesson identifier, e.g. 'junior-theory-1-4'.

輸入參數lesson_id必填

list_lessons

List lesson metadata. Filter by level/category. Args: level: 'junior' | 'senior' | 'vidwat'. category: e.g. 'theory-1', 'practical-1', etc.

輸入參數levelcategory

list_classes

List recent class journal entries (date descending) for YOUR account. Args: mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token while signed in to the app. Scopes results to your journal only. level: optional level filter. limit: max number of classes (1-100, default 20).

輸入參數levellimitmcp_token必填

get_class

Fetch a single class journal entry with its items and practice log. Only returns it if it belongs to your account (mcp_token). Args: class_id: The class to fetch. mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token.

輸入參數class_id必填mcp_token必填

ask_venuvidya

Ask VenuVidya — the in-app RAG chatbot. Returns a grounded answer + citations. Args: question: Student question (2-1500 chars). level: Optional level filter for retrieval ('junior' | 'senior' | 'vidwat'). language: 'en', 'kn' or 'auto'.

輸入參數levellanguagequestion必填

log_practice_session

Log a practice session against a class item in YOUR journal. Args: class_id: Parent class id. item_id: Item id inside the class (kriti/varna/etc.). practiced_on: Date in YYYY-MM-DD. mcp_token: Your personal VenuVidya token — GET /api/auth/mcp-token. Only ever writes into a class this account owns. duration_min: Duration in minutes. notes: Free-text notes. rating: Self-rating 1-5.

輸入參數notesratingitem_id必填class_id必填mcp_token必填duration_minpracticed_on必填

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫，或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用，因此這裡不要求授權條款。此檢查項不計入百分比。