scholar-sidekick-mcp 0.3.4 → 0.4.0

package/dist/mcp-server.mjs

@@ -30087,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;
@@ -30108,6 +30124,7 @@ function registerExportTool(server, config2) {
       inputSchema: ExportCitationInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await exportCitation(config2, {
         text: normalizeIdentifiers(input.text),
         format: input.format,
@@ -30134,6 +30151,7 @@ function registerFormatTool(server, config2) {
       inputSchema: FormatCitationInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await formatCitation(config2, {
         text: normalizeIdentifiers(input.text),
         style: input.style ?? void 0,
@@ -30170,6 +30188,7 @@ function registerResolveTool(server, config2) {
       inputSchema: ResolveIdentifierInput
     },
     async (input) => {
+      if (!config2.rapidApiKey) return missingKeyResult();
       const result = await formatCitation(config2, {
         text: normalizeIdentifiers(input.text),
         output: "json"
@@ -30194,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);
@@ -30230,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.4",
+  "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",