scholar-sidekick-mcp 0.3.3 → 0.4.0

package/dist/mcp-server.mjs

@@ -22170,7 +22170,7 @@ var StdioServerTransport = class {
 // src/types.ts
 var FormatCitationInput = {
   text: external_exports.string().describe(
-    "One or more identifiers (DOIs, PMIDs, ISBNs, arXiv IDs, etc.) separated by newlines"
+    "One or more identifiers (DOIs, PMIDs, ISBNs, arXiv IDs, etc.) separated by newlines or commas"
   ),
   style: external_exports.string().optional().describe("Citation style: vancouver (default), ama, apa, ieee, cse, or any CSL style ID"),
   lang: external_exports.string().optional().describe("Locale for formatting (e.g. en-US, en-GB, fr-FR)"),
@@ -22178,7 +22178,7 @@ var FormatCitationInput = {
   output: external_exports.enum(["text", "html", "json"]).optional().describe("Output format (default: text)")
 };
 var ExportCitationInput = {
-  text: external_exports.string().describe("One or more identifiers (DOIs, PMIDs, ISBNs, etc.) separated by newlines"),
+  text: external_exports.string().describe("One or more identifiers (DOIs, PMIDs, ISBNs, etc.) separated by newlines or commas"),
   format: external_exports.enum([
     "bib",
     "ris",
@@ -22196,7 +22196,7 @@ var ExportCitationInput = {
 };
 var ResolveIdentifierInput = {
   text: external_exports.string().describe(
-    "One or more identifiers to resolve (DOIs, PMIDs, PMCIDs, ISBNs, arXiv IDs, ISSNs, ADS bibcodes) separated by newlines"
+    "One or more identifiers to resolve (DOIs, PMIDs, PMCIDs, ISBNs, arXiv IDs, ISSNs, ADS bibcodes) separated by newlines or commas"
   )
 };
 var SCHOLAR_HEADER_NAMES = [
@@ -30075,6 +30075,9 @@ var EMPTY_COMPLETION_RESULT = {
 };
 
 // src/tools/helpers.ts
+function normalizeIdentifiers(text) {
+  return text.includes(",") && !text.includes("\n") ? text.split(",").map((s) => s.trim()).filter(Boolean).join("\n") : text;
+}
 function errorResult(result) {
   const parts = [];
   if (result.error) parts.push(result.error);
@@ -30084,6 +30087,22 @@ function errorResult(result) {
     isError: true
   };
 }
+var MISSING_KEY_MESSAGE = [
+  "Scholar Sidekick is not configured. Set the RAPIDAPI_KEY environment variable to use this tool.",
+  "",
+  "Get a free key:",
+  "  1. Sign up at https://rapidapi.com/scholar-sidekick-scholar-sidekick-api/api/scholar-sidekick",
+  "  2. Subscribe to the free tier and copy your RapidAPI key",
+  "  3. Restart this MCP server with RAPIDAPI_KEY set",
+  "",
+  "If you installed via Claude Desktop, open the Scholar Sidekick extension settings and paste the key there."
+].join("\n");
+function missingKeyResult() {
+  return {
+    content: [{ type: "text", text: MISSING_KEY_MESSAGE }],
+    isError: true
+  };
+}
 function buildMetadata(result) {
   const meta3 = {};
   if (result.requestId) meta3.requestId = result.requestId;
@@ -30105,8 +30124,9 @@ function registerExportTool(server, config2) {
       inputSchema: ExportCitationInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await exportCitation(config2, {
-        text: input.text,
+        text: normalizeIdentifiers(input.text),
         format: input.format,
         style: input.style ?? void 0,
         lang: input.lang ?? void 0
@@ -30131,8 +30151,9 @@ function registerFormatTool(server, config2) {
       inputSchema: FormatCitationInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await formatCitation(config2, {
-        text: input.text,
+        text: normalizeIdentifiers(input.text),
         style: input.style ?? void 0,
         lang: input.lang ?? void 0,
         footnote: input.footnote ?? void 0,
@@ -30167,8 +30188,9 @@ function registerResolveTool(server, config2) {
       inputSchema: ResolveIdentifierInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await formatCitation(config2, {
-        text: input.text,
+        text: normalizeIdentifiers(input.text),
         output: "json"
       });
       if (!result.ok || result.data?.ok === false) {
@@ -30191,13 +30213,34 @@ function registerResolveTool(server, config2) {
 
 // src/server.ts
 var SERVER_NAME = "scholar-sidekick";
-var SERVER_VERSION = "0.3.0";
+var SERVER_VERSION = "0.4.0";
+var SERVER_INSTRUCTIONS = `Scholar Sidekick MCP turns academic identifiers into clean citations.
+
+When to use this server:
+- The user mentions a bibliographic identifier \u2014 DOI, PMID, PMCID, ISBN, arXiv ID, ISSN, or ADS bibcode
+- The user asks to format references in a citation style (Vancouver, APA, AMA, IEEE, Chicago, Harvard, MLA, Nature, BMJ, Lancet, or any of 10,000+ CSL styles)
+- The user asks to export a bibliography to BibTeX, RIS, EndNote, RefWorks, MEDLINE, Zotero RDF, CSL JSON, or CSV
+
+Tool selection:
+- resolveIdentifier \u2014 when the user wants raw structured metadata (returns CSL JSON: title, authors, journal, year, identifiers)
+- formatCitation \u2014 when the user wants a human-readable citation in a specific style (returns text, HTML, or JSON)
+- exportCitation \u2014 when the user wants a downloadable bibliography file (returns the file contents as a string)
+
+Tips:
+- All tools accept multiple identifiers separated by newlines or commas \u2014 batch when possible to save calls
+- Pass identifiers verbatim. The server tolerates DOI URLs (https://doi.org/...), "PMID:" / "PMC" prefixes, "arXiv:" prefixes, and ISBN hyphens
+- Default style for formatCitation is Vancouver. If the user does not name a style, ask before defaulting`;
 function createMcpServer(config2) {
   const cfg = config2 ?? createConfig();
-  const server = new McpServer({
-    name: SERVER_NAME,
-    version: SERVER_VERSION
-  });
+  const server = new McpServer(
+    {
+      name: SERVER_NAME,
+      version: SERVER_VERSION
+    },
+    {
+      instructions: SERVER_INSTRUCTIONS
+    }
+  );
   registerFormatTool(server, cfg);
   registerExportTool(server, cfg);
   registerResolveTool(server, cfg);
@@ -30227,7 +30270,13 @@ async function checkConnection(baseUrl) {
 }
 async function main() {
   const config2 = createConfig();
-  await checkConnection(config2.baseUrl);
+  if (config2.rapidApiKey) {
+    await checkConnection(config2.baseUrl);
+  } else {
+    process.stderr.write(
+      "Scholar Sidekick MCP started without RAPIDAPI_KEY \u2014 tools will return a configuration message until a key is set. Get one at https://rapidapi.com/scholar-sidekick-scholar-sidekick-api/api/scholar-sidekick\n"
+    );
+  }
   const server = createMcpServer(config2);
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scholar-sidekick-mcp",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "mcpName": "io.github.mlava/scholar-sidekick-mcp",
   "description": "MCP server for Scholar Sidekick — resolve, format, and export academic citations from any AI assistant",
   "license": "MIT",