@upstash/context7-mcp 2.1.7 → 2.2.0

package/README.md

@@ -720,9 +720,35 @@ See [JetBrains AI Assistant Documentation](https://www.jetbrains.com/help/ai-ass
 
 See [Kiro Model Context Protocol Documentation](https://kiro.dev/docs/mcp/configuration/) for details.
 
+[![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=context7&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.context7.com%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D)
+
 1. Navigate `Kiro` > `MCP Servers`
 2. Add a new MCP server by clicking the `+ Add` button.
-3. Paste the configuration given below:
+3. Paste one of the configurations below:
+
+#### Kiro Remote Server Connection
+
+```json
+{
+  "mcpServers": {
+    "Context7": {
+      "url": "https://mcp.context7.com/mcp"
+    }
+  }
+}
+```
+
+To use an API key in Kiro, add:
+
+```json
+"headers": {
+  "CONTEXT7_API_KEY": "YOUR_API_KEY"
+}
+```
+
+You can create an API key at [context7.com/dashboard](https://context7.com/dashboard) for authenticated usage and higher rate limits.
+
+#### Kiro Local Server Connection
 
 ```json
 {

package/dist/index.js

@@ -194,7 +194,7 @@ server.registerTool("query-docs", {
 
 You must call 'Resolve Context7 Library ID' tool first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.
 
-IMPORTANT: Do not call this tool more than 3 times per question. If you cannot find what you need after 3 calls, use the best information you have.`,
+Workflow: call first without researchMode. If that doesn't answer the question, retry with researchMode: true. Do not call each tool more than 3 times per question`,
     inputSchema: {
         libraryId: z
             .string()
@@ -202,12 +202,16 @@ IMPORTANT: Do not call this tool more than 3 times per question. If you cannot f
         query: z
             .string()
             .describe("The question or task you need help with. Be specific and include relevant details. Good: 'How to set up authentication with JWT in Express.js' or 'React useEffect cleanup function examples'. Bad: 'auth' or 'hooks'. The query is sent to the Context7 API for processing. Do not include any sensitive or confidential information such as API keys, passwords, credentials, personal data, or proprietary code in your query."),
+        researchMode: z
+            .boolean()
+            .optional()
+            .describe(`Retry the query with deep research: spins up sandboxed agents that read the actual source repos and runs a live web search, then synthesizes a fresh answer. Set true on retry if you weren't satisfied with the first answer and want a more thorough one. Requires an API key — you can get one free at https://context7.com.`),
     },
     annotations: {
         readOnlyHint: true,
     },
-}, async ({ query, libraryId }) => {
-    const response = await fetchLibraryContext({ query, libraryId }, getClientContext());
+}, async ({ query, libraryId, researchMode }) => {
+    const response = await fetchLibraryContext({ query, libraryId, researchMode }, getClientContext());
     return {
         content: [
             {

package/dist/lib/api.js

@@ -2,6 +2,7 @@ import { generateHeaders } from "./encryption.js";
 import { Agent, ProxyAgent, setGlobalDispatcher } from "undici";
 import { CONTEXT7_API_BASE_URL } from "./constants.js";
 import { readFileSync } from "fs";
+import tls from "tls";
 /**
  * Parses error response from the Context7 API
  * Extracts the server's error message, falling back to status-based messages if parsing fails
@@ -39,21 +40,31 @@ const PROXY_URL = process.env.HTTPS_PROXY ??
     process.env.http_proxy ??
     null;
 const CUSTOM_CA_CERTS = process.env.NODE_EXTRA_CA_CERTS;
-function loadCustomCACerts() {
-    if (!CUSTOM_CA_CERTS)
+export function getDefaultCACertificates() {
+    if (typeof tls.getCACertificates === "function") {
+        return tls.getCACertificates("default");
+    }
+    return [...tls.rootCertificates];
+}
+export function loadCustomCACerts(customCACertsPath = CUSTOM_CA_CERTS) {
+    if (!customCACertsPath)
         return undefined;
     try {
-        return readFileSync(CUSTOM_CA_CERTS);
+        const customCa = readFileSync(customCACertsPath, "utf-8");
+        return [...getDefaultCACertificates(), customCa];
     }
     catch (error) {
-        console.error(`[Context7] Failed to load custom CA certificates from ${CUSTOM_CA_CERTS}:`, error);
+        console.error(`[Context7] Failed to load custom CA certificates from ${customCACertsPath}:`, error);
         return undefined;
     }
 }
 if (PROXY_URL && !PROXY_URL.startsWith("$") && /^(http|https):\/\//i.test(PROXY_URL)) {
     try {
         const ca = loadCustomCACerts();
-        setGlobalDispatcher(new ProxyAgent({ uri: PROXY_URL, ...(ca ? { connect: { ca } } : {}) }));
+        setGlobalDispatcher(new ProxyAgent({
+            uri: PROXY_URL,
+            ...(ca ? { requestTls: { ca }, proxyTls: { ca } } : {}),
+        }));
     }
     catch (error) {
         console.error(`[Context7] Failed to configure proxy agent for provided proxy URL: ${PROXY_URL}:`, error);
@@ -109,6 +120,8 @@ export async function fetchLibraryContext(request, context = {}) {
         const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/context`);
         url.searchParams.set("query", request.query);
         url.searchParams.set("libraryId", request.libraryId);
+        if (request.researchMode)
+            url.searchParams.set("researchMode", "true");
         const headers = generateHeaders(context);
         const response = await fetch(url, { headers });
         if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/context7-mcp",
-  "version": "2.1.7",
+  "version": "2.2.0",
   "mcpName": "io.github.upstash/context7",
   "description": "MCP server for Context7",
   "repository": {
@@ -43,11 +43,12 @@
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.13"
   },
   "scripts": {
     "build": "tsc && chmod 755 dist/index.js",
-    "test": "echo \"No tests yet\"",
+    "test": "pnpm exec vitest run",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "lint:check": "eslint .",