@upstash/context7-mcp 1.0.33 → 1.0.34-canary.1

package/dist/lib/api.js

@@ -1,26 +1,6 @@
 import { generateHeaders } from "./encryption.js";
 import { ProxyAgent, setGlobalDispatcher } from "undici";
-import { DOCUMENTATION_MODES } from "./types.js";
 const CONTEXT7_API_BASE_URL = "https://context7.com/api";
-const DEFAULT_TYPE = "txt";
-/**
- * Parses a Context7-compatible library ID into its components
- * @param libraryId The library ID (e.g., "/vercel/next.js" or "/vercel/next.js/v14.3.0")
- * @returns Object with username, library, and optional tag
- */
-function parseLibraryId(libraryId) {
-    // Remove leading slash if present
-    const cleaned = libraryId.startsWith("/") ? libraryId.slice(1) : libraryId;
-    const parts = cleaned.split("/");
-    if (parts.length < 2) {
-        throw new Error(`Invalid library ID format: ${libraryId}. Expected format: /username/library or /username/library/tag`);
-    }
-    return {
-        username: parts[0],
-        library: parts[1],
-        tag: parts[2], // undefined if not present
-    };
-}
 /**
  * Parses error response from the Context7 API
  * Extracts the server's error message, falling back to status-based messages if parsing fails
@@ -46,7 +26,7 @@ async function parseErrorResponse(response, apiKey) {
             : "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.";
+        return "No documentation found. Try a different library name or refine your query.";
     }
     if (status === 401) {
         return "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix.";
@@ -73,79 +53,36 @@ if (PROXY_URL && !PROXY_URL.startsWith("$") && /^(http|https):\/\//i.test(PROXY_
     }
 }
 /**
- * Searches for libraries matching the given query
- * @param query The search query
- * @param clientIp Optional client IP address to include in headers
- * @param apiKey Optional API key for authentication
- * @returns Search results or null if the request fails
- */
-export async function searchLibraries(query, clientIp, apiKey) {
-    try {
-        const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/search`);
-        url.searchParams.set("query", query);
-        const headers = generateHeaders(clientIp, apiKey);
-        const response = await fetch(url, { headers });
-        if (!response.ok) {
-            const errorMessage = await parseErrorResponse(response, apiKey);
-            console.error(errorMessage);
-            return {
-                results: [],
-                error: errorMessage,
-            };
-        }
-        const searchData = await response.json();
-        return searchData;
-    }
-    catch (error) {
-        const errorMessage = `Error searching libraries: ${error}`;
-        console.error(errorMessage);
-        return { results: [], error: errorMessage };
-    }
-}
-/**
- * Fetches documentation context for a specific library
- * @param libraryId The library ID to fetch documentation for
- * @param docMode Documentation mode (CODE for API references and code examples, INFO for conceptual guides)
- * @param options Optional request parameters (page, limit, topic)
+ * Fetches intelligent, reranked context for a natural language query
+ * @param request The context request parameters (query, topic, library, mode)
  * @param clientIp Optional client IP address to include in headers
  * @param apiKey Optional API key for authentication
- * @returns The documentation text or null if the request fails
+ * @returns Context response with data
  */
-export async function fetchLibraryDocumentation(libraryId, docMode, options = {}, clientIp, apiKey) {
+export async function fetchLibraryContext(request, clientIp, apiKey) {
     try {
-        const { username, library, tag } = parseLibraryId(libraryId);
-        // Build URL path
-        let urlPath = `${CONTEXT7_API_BASE_URL}/v2/docs/${docMode}/${username}/${library}`;
-        if (tag) {
-            urlPath += `/${tag}`;
-        }
-        const url = new URL(urlPath);
-        url.searchParams.set("type", DEFAULT_TYPE);
-        if (options.topic)
-            url.searchParams.set("topic", options.topic);
-        if (options.page)
-            url.searchParams.set("page", options.page.toString());
-        if (options.limit)
-            url.searchParams.set("limit", options.limit.toString());
+        const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/context`);
+        url.searchParams.set("query", request.query);
+        if (request.library)
+            url.searchParams.set("library", request.library);
+        if (request.mode)
+            url.searchParams.set("mode", request.mode);
         const headers = generateHeaders(clientIp, apiKey, { "X-Context7-Source": "mcp-server" });
         const response = await fetch(url, { headers });
         if (!response.ok) {
             const errorMessage = await parseErrorResponse(response, apiKey);
             console.error(errorMessage);
-            return errorMessage;
+            return { data: errorMessage };
         }
         const text = await response.text();
-        if (!text || text === "No content available" || text === "No context data available") {
-            const suggestion = docMode === DOCUMENTATION_MODES.CODE
-                ? " Try mode='info' for guides and tutorials."
-                : " Try mode='code' for API references and code examples.";
-            return `No ${docMode} documentation available for this library.${suggestion}`;
+        if (!text) {
+            return { data: "No documentation found for this query." };
         }
-        return text;
+        return { data: text };
     }
     catch (error) {
-        const errorMessage = `Error fetching library documentation. Please try again later. ${error}`;
+        const errorMessage = `Error fetching library context. Please try again later. ${error}`;
         console.error(errorMessage);
-        return errorMessage;
+        return { data: errorMessage };
     }
 }

package/dist/lib/types.js

@@ -1,7 +1 @@
-/**
- * Documentation modes for fetching library documentation
- */
-export const DOCUMENTATION_MODES = {
-    CODE: "code",
-    INFO: "info",
-};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/context7-mcp",
-  "version": "1.0.33",
+  "version": "1.0.34-canary.1",
   "mcpName": "io.github.upstash/context7",
   "description": "MCP server for Context7",
   "repository": {
@@ -41,7 +41,13 @@
     "zod": "^3.24.2"
   },
   "devDependencies": {
+    "@ai-sdk/anthropic": "^1.2.12",
+    "@ai-sdk/google": "^1.2.7",
+    "@ai-sdk/mcp": "^0.2.0",
+    "@ai-sdk/openai": "^1.3.22",
     "@types/node": "^22.13.14",
+    "ai": "^4.3.16",
+    "dotenv": "^16.5.0",
     "typescript": "^5.8.2"
   },
   "scripts": {
@@ -54,6 +60,8 @@
     "format:check": "prettier --check .",
     "dev": "tsc --watch",
     "start": "node dist/index.js --transport http",
-    "pack-mcpb": "pnpm install && pnpm run build && rm -rf node_modules && pnpm install --prod && mv mcpb/.mcpbignore .mcpbignore && mv mcpb/manifest.json manifest.json && mv public/icon.png icon.png && mcpb validate manifest.json && mcpb pack . mcpb/context7.mcpb && mv manifest.json mcpb/manifest.json && mv .mcpbignore mcpb/.mcpbignore && mv icon.png public/icon.png && bun install"
+    "pack-mcpb": "pnpm install && pnpm run build && rm -rf node_modules && pnpm install --prod && mv mcpb/.mcpbignore .mcpbignore && mv mcpb/manifest.json manifest.json && mv public/icon.png icon.png && mcpb validate manifest.json && mcpb pack . mcpb/context7.mcpb && mv manifest.json mcpb/manifest.json && mv .mcpbignore mcpb/.mcpbignore && mv icon.png public/icon.png && bun install",
+    "run-benchmark": "pnpm run build && node dist/benchmark/run-benchmark.js",
+    "compare-benchmark": "pnpm run build && node dist/benchmark/compare-benchmark.js"
   }
 }