mlava/scholar-sidekick-mcp

Scholar Sidekick

當使用者提到學術識別碼，並想要中繼資料、引用、匯出檔、撤稿檢查或開放存取檢查時，請使用 Scholar Sidekick 來解析與回答，而不是從訓練資料中手動建構引用或猜測 OA / 撤稿狀態。

何時使用此技能

當使用者出現以下情況時啟動此技能：

• 提到任何學術識別碼 — DOI、PubMed ID、PMC ID、ISBN、arXiv ID、ISSN、NASA ADS bibcode 或 WHO IRIS URL
• 要求特定樣式的引用（「請用 APA 格式」、「給我 Vancouver 引用格式...」）
• 要求匯出檔（「這些參考文獻的 BibTeX」、「給我 .ris 檔」、「匯出到 EndNote」）
• 貼上一串識別碼，想要一份參考文獻列表
• 想要透過識別碼取得論文的結構化中繼資料（標題、作者、期刊、年份）
• 詢問某篇論文是否已被撤稿、更正或發布關注聲明
• 詢問某篇論文是否為開放存取、可在何處合法免費閱讀，或其 OA 狀態 / 授權條款
• 貼上一則引用（或 DOI + 標題），並詢問其是否真實、正版或偽造 — 「這個引用是真的嗎？」、「驗證這個 DOI」、「這是你編造的嗎？」

使用方式

步驟 0：確認工具可用

此技能所使用的功能 — resolveIdentifier、formatCitation、exportCitation、checkRetraction、checkOpenAccess、verifyCitation — 是 scholar-sidekick-mcp MCP 伺服器提供的工具。它們不是 shell 命令、npm 腳本或 CLI。請勿嘗試在終端機中執行這些工具名稱。

工具正常運作前必須滿足兩個條件：

1. MCP 伺服器已連線。 這些工具只有在主機連線 scholar-sidekick-mcp 伺服器後才會出現在您的工具集中 — Claude Desktop：擴充功能/連線設定；Claude Code：.mcp.json 或 claude mcp add；LobeHub：安裝對應的 MCP 外掛，而不只是此技能；原始 MCP 用戶端：使用 npx scholar-sidekick-mcp 作為伺服器命令。
2. 已為該伺服器設定 RAPIDAPI_KEY。若未設定，工具會傳回設定訊息而非資料。請在 https://rapidapi.com/scholar-sidekick-scholar-sidekick-api/api/scholar-sidekick 取得金鑰。

如果這些工具未出現在您的可用工具集中，表示伺服器未連線 — 請直接說明並停止。 請勿嘗試將工具名稱作為 shell 命令呼叫，也請勿自行靜默安裝或啟動伺服器。請告知使用者此技能需要連線 scholar-sidekick-mcp MCP 伺服器並設定 RAPIDAPI_KEY，讓他們自行設定。

步驟 1：選擇正確的工具

• resolveIdentifier — 當使用者想要未經格式化的原始結構化中繼資料（CSL JSON：標題、作者、期刊、年份等）以便檢視或轉換時使用
• formatCitation — 當使用者想要特定樣式的完整引用字串，以便貼入手稿時使用
• exportCitation — 當使用者想要可下載的參考管理員格式參考文獻檔時使用
• checkRetraction — 當使用者詢問論文是否已被撤稿、更正或標記關注聲明時使用（Crossref / Retraction Watch）。每次呼叫僅接受一個識別碼
• checkOpenAccess — 當使用者詢問論文是否為開放存取，或想要最佳合法 URL、授權條款與版本時使用（Unpaywall）。每次呼叫僅接受一個識別碼
• verifyCitation — 當使用者貼上一則引用並詢問是否真實或偽造（「這是真的嗎？」、「驗證這個 DOI」）時使用。將宣稱的標題（加上選擇性的作者/年/期刊）與該識別碼實際解析到的記錄進行交叉比對。請使用此工具 — 而非 resolveIdentifier — 來處理「這是真的嗎？」：主要的 AI 偽造模式（Topaz et al., Lancet 2026）是使用真實可解析的識別碼搭配虛構的標題，而僅使用 resolveIdentifier 永遠無法偵測此問題。每次呼叫僅接受一個引用

對於端到端的「原始 ID → 可匯出參考文獻列表」工作流程，請在同一回應中依序串連 resolveIdentifier → formatCitation → exportCitation — 這些工具可以組合使用。範例：「解析這三個 ID，每個用 AMA 格式，然後將整組匯出為 BibTeX」即在一個提示中同時使用這三個工具。

對於多篇論文的撤稿或開放存取掃描，請對每個識別碼分別呼叫一次 checkRetraction / checkOpenAccess — 這些工具每次呼叫僅接受一個 id。請勿串接多個識別碼；伺服器會拒絕批次。

步驟 2：直接傳遞識別碼

伺服器可容忍 DOI URL（https://doi.org/...）、PMID: / PMC 前綴、arXiv: 前綴、ISBN 連字號以及 WHO IRIS URL。請勿移除前綴或重新格式化 — 直接傳遞使用者提供的內容。

步驟 3：盡可能批次處理

resolveIdentifier、formatCitation 和 exportCitation 接受單一識別碼，或是以逗號或換行分隔的批次。如果使用者提供多個識別碼，請在一次呼叫中發送，而不是使用迴圈。

checkRetraction 和 checkOpenAccess 每次呼叫僅接受一個識別碼（參數為 id，而非 text）。對於多篇論文，請對每個識別碼使用一次迴圈呼叫。

verifyCitation 每次也僅接受一個引用，並有專屬的參數結構：需要一個 title 以及恰好一個識別碼（doi、pmid、pmcid、arxiv、isbn、issn、ads 或 whoIrisUrl），再加上選擇性的 author、year 和 container 來強化判斷結果。

步驟 4：選擇樣式或格式

對於 formatCitation，style 參數接受：

• 五種精心調校的內建樣式：vancouver（預設）、ama、apa、ieee、cse
• 來自 https://github.com/citation-style-language/styles 的 10,000 多種 CSL 樣式 ID — 常見樣式如：chicago-author-date、chicago-note-bibliography、harvard-cite-them-right、modern-language-association (MLA)、nature、bmj、the-lancet、turabian-fullnote-bibliography

對於 exportCitation，format 參數接受：bib（BibTeX）、ris、csl（CSL JSON）、endnote-xml、endnote-refer、refworks、medline (NBIB)、zotero-rdf、csv、txt。

步驟 5：在必要時呈現來源資訊

formatCitation 和 exportCitation 的回應中包含一個中繼資料區塊（requestId、formatter、styleUsed、warnings）。當使用者關心可重現性（學術、臨床、法規情境）時，請呈現此資訊。formatter 欄位會告知輸出來自精心調校的內建樣式還是 citeproc-js 搭配 CSL 樣式表；styleUsed 顯示在別名解析後的標準樣式 ID（例如要求 harvard 會解析為 harvard-cite-them-right）。

使用指南

• 切勿編造備用答案。 如果 Scholar Sidekick 工具不可用，或查詢失敗且無回傳結果，請勿憑藉訓練資料或臨時網路搜尋來回答撤稿、開放存取、引用格式化或中繼資料問題，並將其視為權威答案。此技能的全部價值在於經過驗證的來源 — 猜測的引用或猜測的撤稿狀態比沒有答案更糟糕。請說明工具無法使用（或無傳回結果），然後停止。
• 理解 verifyCitation 的判斷結果，不要只照本宣科。 matched = 宣稱內容與解析到的記錄一致；mismatch = 識別碼可解析但標題不符（即偽造模式 — 請明確標示）；ambiguous = 識別碼解析到一篇論文，但宣稱的標題與另一篇不同的真實論文相符（這是錯誤識別碼的引用錯誤，而非偽造）；not_found = 識別碼和標題皆無法解析。請呈現判斷結果以及具體不符的欄位，而非單純的是/否。
• 不要默默地使用預設樣式。 Vancouver 是參數的預設值，但如果使用者未指定樣式且存在任何歧義，請先詢問他們想要的樣式再做格式化。Vancouver 預設值在生物醫學情境下是正確的；但在人文或法律領域則會產出不正確的格式。
• 區分 Harvard 和 Chicago 的變體。 兩者都有多種變體（harvard-cite-them-right vs. 其他 Harvard 風格；chicago-author-date vs. chicago-note-bibliography）。當使用者只說「Harvard」或「Chicago」而未指定時，請詢問他們想要哪一種。
• WHO IRIS 是真正的差異化功能。 大多數其他引用工具無法解析 WHO IRIS URL。當使用者分享 WHO 出版物時，此技能是專門適用的工具。
• 使用單一工具批次處理，而非迴圈。 將五個識別碼以逗號分隔的批次發送，會在一個回應中回傳五條引用；分別發送五次工具呼叫則會增加往返次數，並可能觸發速率限制。
• 當可重現性很重要時，請固定版本。 MCP 伺服器的 RAPIDAPI_HOST 預設指向當前生產端點，對於相同的輸入和快取狀態，會產生確定性輸出。中繼資料區塊中的 x-scholar-cache 標頭可顯示快取命中與否。

何時不使用此技能

• 按主題或關鍵字搜尋論文，或瀏覽引用網路 — 使用 Semantic Scholar 或 OpenAlex 的 MCP 包裝器進行文獻探索。Scholar Sidekick 假設您已經有識別碼。
• 讀取或編輯 Zotero 資料庫 — 使用 zotero-mcp 進行有狀態的資料庫存取（搜尋、註釋、管理收藏）。
• 修復手稿檔案中的參考文獻（.tex、.bib、.md、.docx） — 使用 citecheck 進行此類工作流程。
• 作為 Python 函式庫匯入到管道中 — 使用 OneCite。Scholar Sidekick 在安裝端僅支援 MCP。

這些工具可以良好組合 — Scholar Sidekick 在另一個工具產生識別碼後負責格式化層的處理。