@upstash/context7-mcp 1.0.15 → 1.0.17

package/README.md

@@ -1,3 +1,5 @@
+![Cover](public/cover.png)
+
 # 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)
@@ -11,7 +13,7 @@
 LLMs rely on outdated or generic information about the libraries you use. You get:
 
 - ❌ Code examples are outdated and based on year-old training data
-- ❌ Hallucinated APIs don't even exist
+- ❌ Hallucinated APIs that don't even exist
 - ❌ Generic answers for old package versions
 
 ## ✅ With Context7
@@ -46,7 +48,12 @@ Check out our [project addition guide](./docs/adding-projects.md) to learn how t
 
 - Node.js >= v18.0.0
 - Cursor, Claude Code, VSCode, Windsurf or another MCP Client
-- Context7 API Key (Optional for higher rate limits) (Get yours by creating an account at [context7.com/console](https://context7.com/console))
+- Context7 API Key (Optional for higher rate limits) (Get yours by creating an account at [context7.com/dashboard](https://context7.com/dashboard))
+
+> [!WARNING]
+> **SSE Protocol Deprecation Notice**
+>
+> The Server-Sent Events (SSE) transport protocol is deprecated and its endpoint will be removed in upcoming releases. Please use HTTP or stdio transport methods instead.
 
 <details>
 <summary><b>Installing via Smithery</b></summary>
@@ -107,7 +114,7 @@ Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file i
 <details>
 <summary><b>Install in Claude Code</b></summary>
 
-Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more info.
+Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more info.
 
 #### Claude Code Remote Server Connection
 
@@ -115,12 +122,6 @@ Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/
 claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"
 ```
 
-Or using SSE transport:
-
-```sh
-claude mcp add --transport sse context7 https://mcp.context7.com/sse --header "CONTEXT7_API_KEY: YOUR_API_KEY"
-```
-
 #### Claude Code Local Server Connection
 
 ```sh
@@ -333,7 +334,8 @@ See [Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/t
     "context7": {
       "httpUrl": "https://mcp.context7.com/mcp",
       "headers": {
-        "CONTEXT7_API_KEY": "YOUR_API_KEY"
+        "CONTEXT7_API_KEY": "YOUR_API_KEY",
+        "Accept": "application/json, text/event-stream"
       }
     }
   }
@@ -752,11 +754,13 @@ Add this to your Visual Studio MCP config file (see the [Visual Studio docs](htt
 
 ```json
 {
-  "mcp": {
-    "servers": {
-      "context7": {
-        "type": "http",
-        "url": "https://mcp.context7.com/mcp"
+  "inputs": [],
+  "servers": {
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "YOUR_API_KEY"
       }
     }
   }
@@ -805,23 +809,6 @@ Add this to your Crush configuration file. See [Crush MCP docs](https://github.c
 }
 ```
 
-#### Crush Remote Server Connection (SSE)
-
-```json
-{
-  "$schema": "https://charm.land/crush.json",
-  "mcp": {
-    "context7": {
-      "type": "sse",
-      "url": "https://mcp.context7.com/sse",
-      "headers": {
-        "CONTEXT7_API_KEY": "YOUR_API_KEY"
-      }
-    }
-  }
-}
-```
-
 #### Crush Local Server Connection
 
 ```json
@@ -983,13 +970,12 @@ See [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/help-center
 Context7 MCP provides the following tools that LLMs can use:
 
 - `resolve-library-id`: Resolves a general library name into a Context7-compatible library ID.
-
   - `libraryName` (required): The name of the library to search for
 
 - `get-library-docs`: Fetches documentation for a library using a Context7-compatible library ID.
   - `context7CompatibleLibraryID` (required): Exact Context7-compatible library ID (e.g., `/mongodb/docs`, `/vercel/next.js`)
   - `topic` (optional): Focus the docs on a specific topic (e.g., "routing", "hooks")
-  - `tokens` (optional, default 10000): Max number of tokens to return. Values less than the default value of 10000 are automatically increased to 10000.
+  - `tokens` (optional, default 5000): Max number of tokens to return. Values less than 1000 are automatically increased to 1000.
 
 ## 🛟 Tips
 
@@ -1015,6 +1001,10 @@ Context7 MCP provides the following tools that LLMs can use:
 >
 > The slash syntax tells the MCP tool exactly which library to load docs for.
 
+### HTTPS Proxy
+
+If you are behind an HTTP proxy, Context7 uses the standard `https_proxy` / `HTTPS_PROXY` environment variables.
+
 ## 💻 Development
 
 Clone the project and install dependencies:
@@ -1041,7 +1031,7 @@ bun run dist/index.js
 
 - `--transport <stdio|http>` – Transport to use (`stdio` by default). Note that HTTP transport automatically provides both HTTP and SSE endpoints.
 - `--port <number>` – Port to listen on when using `http` transport (default `3000`).
-- `--api-key <key>` – API key for authentication. You can get your API key by creating an account at [context7.com/console](https://context7.com/console).
+- `--api-key <key>` – API key for authentication. You can get your API key by creating an account at [context7.com/dashboard](https://context7.com/dashboard).
 
 Example with http transport and port 8080:
 

package/dist/index.js

@@ -8,11 +8,16 @@ import { createServer } from "http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { Command } from "commander";
-const DEFAULT_MINIMUM_TOKENS = 10000;
+/** Minimum allowed tokens for documentation retrieval */
+const MINIMUM_TOKENS = 1000;
+/** Default tokens when none specified */
+const DEFAULT_TOKENS = 5000;
+/** Default HTTP server port */
+const DEFAULT_PORT = 3000;
 // Parse CLI arguments using commander
 const program = new Command()
     .option("--transport <stdio|http>", "transport type", "stdio")
-    .option("--port <number>", "port for HTTP transport", "3000")
+    .option("--port <number>", "port for HTTP transport", DEFAULT_PORT.toString())
     .option("--api-key <key>", "API key for authentication")
     .allowUnknownOption() // let MCP Inspector / other wrappers pass through extra flags
     .parse(process.argv);
@@ -72,7 +77,7 @@ function getClientIp(req) {
 function createServerInstance(clientIp, apiKey) {
     const server = new McpServer({
         name: "Context7",
-        version: "1.0.15",
+        version: "1.0.17",
     }, {
         instructions: "Use this server to retrieve up-to-date documentation and code examples for any library.",
     });
@@ -154,11 +159,11 @@ ${resultsText}`,
                 .describe("Topic to focus documentation on (e.g., 'hooks', 'routing')."),
             tokens: z
                 .preprocess((val) => (typeof val === "string" ? Number(val) : val), z.number())
-                .transform((val) => (val < DEFAULT_MINIMUM_TOKENS ? DEFAULT_MINIMUM_TOKENS : val))
+                .transform((val) => (val < MINIMUM_TOKENS ? MINIMUM_TOKENS : val))
                 .optional()
-                .describe(`Maximum number of tokens of documentation to retrieve (default: ${DEFAULT_MINIMUM_TOKENS}). Higher values provide more context but consume more tokens.`),
+                .describe(`Maximum number of tokens of documentation to retrieve (default: ${DEFAULT_TOKENS}). Higher values provide more context but consume more tokens.`),
         },
-    }, async ({ context7CompatibleLibraryID, tokens = DEFAULT_MINIMUM_TOKENS, topic = "" }) => {
+    }, async ({ context7CompatibleLibraryID, tokens = DEFAULT_TOKENS, topic = "" }) => {
         const fetchDocsResponse = await fetchLibraryDocumentation(context7CompatibleLibraryID, {
             tokens,
             topic,
@@ -188,7 +193,7 @@ async function main() {
     const transportType = TRANSPORT_TYPE;
     if (transportType === "http") {
         // Get initial port from environment or use default
-        const initialPort = CLI_PORT ?? 3000;
+        const initialPort = CLI_PORT ?? DEFAULT_PORT;
         // Keep track of which port we end up using
         let actualPort = initialPort;
         const httpServer = createServer(async (req, res) => {

package/dist/lib/api.js

@@ -1,6 +1,26 @@
 import { generateHeaders } from "./encryption.js";
+import { ProxyAgent, setGlobalDispatcher } from "undici";
 const CONTEXT7_API_BASE_URL = "https://context7.com/api";
 const DEFAULT_TYPE = "txt";
+// Pick up proxy configuration in a variety of common env var names.
+const PROXY_URL = process.env.HTTPS_PROXY ??
+    process.env.https_proxy ??
+    process.env.HTTP_PROXY ??
+    process.env.http_proxy ??
+    null;
+if (PROXY_URL && !PROXY_URL.startsWith("$") && /^(http|https):\/\//i.test(PROXY_URL)) {
+    try {
+        // Configure a global proxy agent once at startup. Subsequent fetch calls will
+        // automatically use this dispatcher.
+        // Using `any` cast because ProxyAgent implements the Dispatcher interface but
+        // TS may not infer it correctly in some versions.
+        setGlobalDispatcher(new ProxyAgent(PROXY_URL));
+    }
+    catch (error) {
+        // Don't crash the app if proxy initialisation fails – just log a warning.
+        console.error(`[Context7] Failed to configure proxy agent for provided proxy URL: ${PROXY_URL}:`, error);
+    }
+}
 /**
  * Searches for libraries matching the given query
  * @param query The search query

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/context7-mcp","version":"1.0.15","description":"MCP server for Context7","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod 755 dist/index.js","format":"prettier --write .","lint":"eslint \"**/*.{js,ts,tsx}\" --fix","lint:check":"eslint \"**/*.{js,ts,tsx}\"","start":"node dist/index.js --transport http","pack-dxt":"bun install && bun run build && rm -rf node_modules && bun install --production && mv dxt/.dxtignore .dxtignore && mv dxt/manifest.json manifest.json && dxt validate manifest.json && dxt pack . dxt/context7.dxt && mv manifest.json dxt/manifest.json && mv .dxtignore dxt/.dxtignore && bun install"},"repository":{"type":"git","url":"git+https://github.com/upstash/context7.git"},"keywords":["modelcontextprotocol","mcp","context7"],"author":"abdush","license":"MIT","type":"module","bin":{"context7-mcp":"dist/index.js"},"files":["dist"],"bugs":{"url":"https://github.com/upstash/context7/issues"},"homepage":"https://github.com/upstash/context7#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.13.2","commander":"^14.0.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.14","@typescript-eslint/eslint-plugin":"^8.28.0","@typescript-eslint/parser":"^8.28.0","eslint":"^9.23.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.5","prettier":"^3.5.3","typescript":"^5.8.2","typescript-eslint":"^8.28.0"}}
+{"name":"@upstash/context7-mcp","version":"1.0.17","description":"MCP server for Context7","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod 755 dist/index.js","format":"prettier --write .","lint":"eslint \"**/*.{js,ts,tsx}\" --fix","lint:check":"eslint \"**/*.{js,ts,tsx}\"","start":"node dist/index.js --transport http","pack-dxt":"bun install && bun run build && rm -rf node_modules && bun install --production && mv dxt/.dxtignore .dxtignore && mv dxt/manifest.json manifest.json && dxt validate manifest.json && dxt pack . dxt/context7.dxt && mv manifest.json dxt/manifest.json && mv .dxtignore dxt/.dxtignore && bun install"},"repository":{"type":"git","url":"git+https://github.com/upstash/context7.git"},"keywords":["modelcontextprotocol","mcp","context7"],"author":"abdush","license":"MIT","type":"module","bin":{"context7-mcp":"dist/index.js"},"files":["dist"],"bugs":{"url":"https://github.com/upstash/context7/issues"},"homepage":"https://github.com/upstash/context7#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.13.2","commander":"^14.0.0","undici":"^6.6.3","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.14","@typescript-eslint/eslint-plugin":"^8.28.0","@typescript-eslint/parser":"^8.28.0","eslint":"^9.34.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.5","prettier":"^3.6.2","typescript":"^5.8.2","typescript-eslint":"^8.28.0"}}