@upstash/context7-mcp 4.0.0 → 4.0.2

package/README.md

@@ -4,7 +4,7 @@
 
 # Context7 MCP - Up-to-date Code Docs For Any Prompt
 
-[![Website](https://img.shields.io/badge/Website-context7.com-blue)](https://context7.com) [![smithery badge](https://smithery.ai/badge/@upstash/context7-mcp)](https://smithery.ai/server/@upstash/context7-mcp) [![NPM Version](https://img.shields.io/npm/v/%40upstash%2Fcontext7-mcp?color=red)](https://www.npmjs.com/package/@upstash/context7-mcp) [![MIT licensed](https://img.shields.io/npm/l/%40upstash%2Fcontext7-mcp)](./LICENSE)
+[![Website](https://img.shields.io/badge/Website-context7.com-blue)](https://context7.com) [![NPM Version](https://img.shields.io/npm/v/%40upstash%2Fcontext7-mcp?color=red)](https://www.npmjs.com/package/@upstash/context7-mcp) [![MIT licensed](https://img.shields.io/npm/l/%40upstash%2Fcontext7-mcp)](./LICENSE)
 
 [![繁體中文](https://img.shields.io/badge/docs-繁體中文-yellow)](./i18n/README.zh-TW.md) [![简体中文](https://img.shields.io/badge/docs-简体中文-yellow)](./i18n/README.zh-CN.md) [![日本語](https://img.shields.io/badge/docs-日本語-b7003a)](./i18n/README.ja.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./i18n/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./i18n/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./i18n/README.fr.md) [![Documentação em Português (Brasil)](<https://img.shields.io/badge/docs-Português%20(Brasil)-purple>)](./i18n/README.pt-BR.md) [![Documentazione in italiano](https://img.shields.io/badge/docs-Italian-red)](./i18n/README.it.md) [![Dokumentasi Bahasa Indonesia](https://img.shields.io/badge/docs-Bahasa%20Indonesia-pink)](./i18n/README.id-ID.md) [![Dokumentation auf Deutsch](https://img.shields.io/badge/docs-Deutsch-darkgreen)](./i18n/README.de.md) [![Документация на русском языке](https://img.shields.io/badge/docs-Русский-darkblue)](./i18n/README.ru.md) [![Українська документація](https://img.shields.io/badge/docs-Українська-lightblue)](./i18n/README.uk.md) [![Türkçe Doküman](https://img.shields.io/badge/docs-Türkçe-blue)](./i18n/README.tr.md) [![Arabic Documentation](https://img.shields.io/badge/docs-Arabic-white)](./i18n/README.ar.md) [![Tiếng Việt](https://img.shields.io/badge/docs-Tiếng%20Việt-red)](./i18n/README.vi.md)
 
@@ -1621,10 +1621,6 @@ Stay updated and join our community:
 - [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)
 - [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)
 
-## ⭐ Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=upstash/context7&type=Date)](https://www.star-history.com/#upstash/context7&Date)
-
 ## 📄 License
 
 MIT

package/dist/index.js

@@ -282,14 +282,17 @@ async function main() {
         // no session store. The handler serves modern (2026-07-28) traffic natively
         // and 2025-era traffic through its stateless legacy fallback, which answers
         // GET/DELETE (session operations) with 405.
-        //
-        // responseMode "sse" keeps responses streaming: headers flush immediately
-        // after parsing the request rather than buffering until the tool returns.
-        // This is required for long-running tools because some MCP HTTP clients cap
-        // the underlying fetch at 60s waiting for headers, even though the per-tool
-        // timeout is much higher.
+        // keepAliveMs: 0 disables SSE keepalive heartbeats. Every tool here is a
+        // millisecond vector query (p100 ~28s), so no legitimate exchange needs a
+        // heartbeat to stay alive — but a hung exchange kept "alive" by heartbeats
+        // can never be reaped by the gateway's stream idle timeout. A batch
+        // carrying a request plus its own notifications/cancelled produces exactly
+        // that: per spec the cancelled request gets no response, the SDK transport
+        // then never closes the stream, and with heartbeats it survived until the
+        // gateway's 1200s hard cap (the 2026-08-11 outage). Silent hangs instead
+        // go idle and the gateway reaps them at streamIdleTimeout (300s).
         const mcpHandler = createMcpHandler(() => createMcpServer(), {
-            responseMode: "sse",
+            keepAliveMs: 0,
             onerror: (error) => console.error("MCP handler error:", error),
         });
         // Without onerror, request-conversion / handler.fetch throws are answered

package/dist/lib/api.js

@@ -3,6 +3,13 @@ import { Agent, ProxyAgent, setGlobalDispatcher } from "undici";
 import { CONTEXT7_API_BASE_URL } from "./constants.js";
 import { readFileSync } from "fs";
 import tls from "tls";
+/**
+ * Ceiling on a single Context7 API call. Without a signal a stalled backend
+ * call rides undici's ~300s default before failing. 60s is generous for these
+ * vector queries: p99.9 is ~3.2s, and no request exceeded 30s across a full
+ * day of production traffic.
+ */
+const API_TIMEOUT_MS = 60_000;
 /**
  * Parses error response from the Context7 API
  * Extracts the server's error message, falling back to status-based messages if parsing fails
@@ -99,7 +106,7 @@ export async function searchLibraries(query, libraryName, context = {}) {
         url.searchParams.set("query", query);
         url.searchParams.set("libraryName", libraryName);
         const headers = generateHeaders(context);
-        const response = await fetch(url, { headers });
+        const response = await fetch(url, { headers, signal: AbortSignal.timeout(API_TIMEOUT_MS) });
         readPromptSignal(response, context);
         if (!response.ok) {
             const errorMessage = await parseErrorResponse(response, context.apiKey);
@@ -127,7 +134,7 @@ export async function fetchLibraryContext(request, context = {}) {
         url.searchParams.set("query", request.query);
         url.searchParams.set("libraryId", request.libraryId);
         const headers = generateHeaders(context);
-        const response = await fetch(url, { headers });
+        const response = await fetch(url, { headers, signal: AbortSignal.timeout(API_TIMEOUT_MS) });
         readPromptSignal(response, context);
         if (!response.ok) {
             const errorMessage = await parseErrorResponse(response, context.apiKey);

package/package.json

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