@upstash/context7-mcp 1.0.32-canary-20251209084107 → 1.0.33

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/index.js

@@ -103,7 +103,8 @@ For ambiguous queries, request clarification before proceeding with a best-guess
     },
 }, async ({ libraryName }) => {
     const ctx = requestContext.getStore();
-    const searchResponse = await searchLibraries(libraryName, ctx?.clientIp, ctx?.apiKey);
+    const apiKey = ctx?.apiKey || globalApiKey;
+    const searchResponse = await searchLibraries(libraryName, ctx?.clientIp, apiKey);
     if (!searchResponse.results || searchResponse.results.length === 0) {
         return {
             content: [

package/dist/lib/api.js

@@ -22,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. 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 ??
@@ -77,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: [],
@@ -122,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/context7-mcp",
-  "version": "1.0.32-canary-20251209084107",
+  "version": "1.0.33",
   "mcpName": "io.github.upstash/context7",
   "description": "MCP server for Context7",
   "repository": {