@upstash/context7-mcp 1.0.31 → 1.0.32

package/README.md

@@ -1,4 +1,4 @@
-![Cover](public/cover.png)
+![Cover](https://github.com/upstash/context7/blob/master/public/cover.png?raw=true)
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/Install%20in%20VS%20Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)
 

package/dist/lib/api.js

@@ -1,7 +1,6 @@
 import { generateHeaders } from "./encryption.js";
 import { ProxyAgent, setGlobalDispatcher } from "undici";
 import { DOCUMENTATION_MODES } from "./types.js";
-import { maskApiKey } from "./utils.js";
 const CONTEXT7_API_BASE_URL = "https://context7.com/api";
 const DEFAULT_TYPE = "txt";
 /**
@@ -23,27 +22,36 @@ function parseLibraryId(libraryId) {
     };
 }
 /**
- * Generates appropriate error messages based on HTTP status codes
- * @param errorCode The HTTP error status code
- * @param apiKey Optional API key (used for rate limit message)
+ * Parses error response from the Context7 API
+ * Extracts the server's error message, falling back to status-based messages if parsing fails
+ * @param response The fetch Response object
+ * @param apiKey Optional API key (used for fallback messages)
  * @returns Error message string
  */
-function createErrorMessage(errorCode, apiKey) {
-    switch (errorCode) {
-        case 429:
-            return apiKey
-                ? "Rate limited due to too many requests. Please try again later."
-                : "Rate limited due to too many requests. You can create a free API key at https://context7.com/dashboard for higher rate limits.";
-        case 404:
-            return "The library you are trying to access does not exist. Please try with a different library ID.";
-        case 401:
-            if (!apiKey) {
-                return "Unauthorized. Please provide an API key.";
-            }
-            return `Unauthorized. Please check your API key. The API key you provided (possibly incorrect) is: ${maskApiKey(apiKey)}. API keys should start with 'ctx7sk'`;
-        default:
-            return `Failed to fetch documentation. Please try again later. Error code: ${errorCode}`;
+async function parseErrorResponse(response, apiKey) {
+    try {
+        const json = (await response.json());
+        if (json.message) {
+            return json.message;
+        }
+    }
+    catch {
+        // JSON parsing failed, fall through to default
+    }
+    // Fallback for non-JSON responses
+    const status = response.status;
+    if (status === 429) {
+        return apiKey
+            ? "Rate limited or quota exceeded. Upgrade your plan at https://context7.com/plans for higher limits."
+            : "Rate limited or quota exceeded. Create a free API key at https://context7.com/dashboard for higher limits.";
+    }
+    if (status === 404) {
+        return "The library you are trying to access does not exist. Please try with a different library ID.";
+    }
+    if (status === 401) {
+        return "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix.";
     }
+    return `Request failed with status ${status}. Please try again later.`;
 }
 // Pick up proxy configuration in a variety of common env var names.
 const PROXY_URL = process.env.HTTPS_PROXY ??
@@ -78,8 +86,7 @@ export async function searchLibraries(query, clientIp, apiKey) {
         const headers = generateHeaders(clientIp, apiKey);
         const response = await fetch(url, { headers });
         if (!response.ok) {
-            const errorCode = response.status;
-            const errorMessage = createErrorMessage(errorCode, apiKey);
+            const errorMessage = await parseErrorResponse(response, apiKey);
             console.error(errorMessage);
             return {
                 results: [],
@@ -123,8 +130,7 @@ export async function fetchLibraryDocumentation(libraryId, docMode, options = {}
         const headers = generateHeaders(clientIp, apiKey, { "X-Context7-Source": "mcp-server" });
         const response = await fetch(url, { headers });
         if (!response.ok) {
-            const errorCode = response.status;
-            const errorMessage = createErrorMessage(errorCode, apiKey);
+            const errorMessage = await parseErrorResponse(response, apiKey);
             console.error(errorMessage);
             return errorMessage;
         }

package/dist/lib/utils.js

@@ -58,20 +58,3 @@ export function formatSearchResults(searchResponse) {
     const formattedResults = searchResponse.results.map(formatSearchResult);
     return formattedResults.join("\n----------\n");
 }
-/**
- * Masks an API key by showing only the first 10 characters and last 4 characters.
- * This prevents full API keys from being exposed in logs while maintaining some
- * identifiability for debugging.
- *
- * @param apiKey The API key to mask
- * @returns Masked API key string (e.g., "ctx7sk-abc...xyz1") or "[NO-API-KEY]" if no key provided
- */
-export function maskApiKey(apiKey) {
-    if (apiKey.length <= 14) {
-        // If the key is too short to mask meaningfully, just show first part
-        return apiKey.substring(0, 7) + "...";
-    }
-    const firstPart = apiKey.substring(0, 10);
-    const lastPart = apiKey.substring(apiKey.length - 4);
-    return `${firstPart}...${lastPart}`;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/context7-mcp",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "mcpName": "io.github.upstash/context7",
   "description": "MCP server for Context7",
   "repository": {
@@ -46,7 +46,8 @@
   },
   "scripts": {
     "build": "tsc && chmod 755 dist/index.js",
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "echo \"No tests yet\"",
+    "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "lint:check": "eslint .",
     "format": "prettier --write .",