@upstash/context7-mcp 1.0.27 → 1.0.28

package/README.md

@@ -20,7 +20,7 @@ LLMs rely on outdated or generic information about the libraries you use. You ge
 
 Context7 MCP pulls up-to-date, version-specific documentation and code examples straight from the source — and places them directly into your prompt.
 
-Add `use context7` to your prompt in Cursor:
+Add `use context7` to your prompt (or [set up a rule](#️-installation) to auto-invoke):
 
 ```txt
 Create a Next.js middleware that checks for a valid JWT in cookies
@@ -35,7 +35,7 @@ JSON API responses for five minutes. use context7
 Context7 fetches up-to-date code examples and documentation right into your LLM's context.
 
 - 1️⃣ Write your prompt naturally
-- 2️⃣ Tell the LLM to `use context7`
+- 2️⃣ Tell the LLM to `use context7` (or [set up a rule](#️-installation) once)
 - 3️⃣ Get working code answers
 
 No tab-switching, no hallucinated APIs that don't exist, no outdated code generation.
@@ -55,6 +55,26 @@ Check out our [project addition guide](https://context7.com/docs/adding-librarie
 - Cursor, Claude Code, VSCode, Windsurf or another MCP Client
 - Context7 API Key (Optional) for higher rate limits and private repositories (Get yours by creating an account at [context7.com/dashboard](https://context7.com/dashboard))
 
+> [!TIP]
+> **Recommended Post-Setup: Add a Rule to Auto-Invoke Context7**
+>
+> After installing Context7 (see instructions below), enhance your workflow by adding a rule so you don't have to type `use context7` in every prompt. Define a simple rule in your MCP client's rule section to automatically invoke Context7 on any code question:
+>
+> - For Windsurf, in `.windsurfrules` file
+> - For Cursor, from `Cursor Settings > Rules` section
+> - For Claude Code, in `CLAUDE.md` file
+> - Or the equivalent in your MCP client
+>
+> **Example Rule:**
+>
+> ```txt
+> Always use context7 when I need code generation, setup or configuration steps, or
+> library/API documentation. This means you should automatically use the Context7 MCP
+> tools to resolve library id and get library docs without me having to explicitly ask.
+> ```
+>
+> From then on, you'll get Context7's docs in any related conversation without typing anything extra. You can alter the rule to match your use cases.
+
 <details>
 <summary><b>Installing via Smithery</b></summary>
 
@@ -260,6 +280,76 @@ Or you can directly edit MCP servers configuration:
 
 </details>
 
+<details>
+<summary><b>Install in Kilo Code</b></summary>
+
+You can configure the Context7 MCP server in **Kilo Code** using either the UI or by editing your project's MCP configuration file.
+
+Kilo Code supports two configuration levels:
+
+- **Global MCP Configuration** — stored in `mcp_settings.json`
+- **Project-level MCP Configuration** — stored in `.kilocode/mcp.json` (recommended)
+
+If a server is defined in both places, the **project-level configuration overrides the global one**.
+
+---
+
+## Configure via Kilo Code UI
+
+1. Open **Kilo Code**.
+2. Click the **Settings** icon in the top-right corner.
+3. Navigate to **Settings → MCP Servers**.
+4. Click **Add Server**.
+5. Choose **HTTP Server** (Streamable HTTP Transport).
+6. Enter the details:
+
+**URL**
+`https://mcp.context7.com/mcp`
+
+**Headers → Add Header**
+- **Key:** `Authorization`
+- **Value:** `Bearer YOUR_API_KEY`
+
+7. Click **Save**.
+8. Ensure the server toggle is **enabled**.
+9. If needed, click **Refresh MCP Servers** to reload the configuration.
+
+---
+
+## Manual Configuration (`.kilocode/mcp.json`)
+
+To configure the server at the project level (recommended for team environments), create the following file:
+
+**`.kilocode/mcp.json`:**
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "type": "streamable-http",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      },
+      "alwaysAllow": [],
+      "disabled": false
+    }
+  }
+}
+```
+
+Replace YOUR_API_KEY with your actual Context7 API key.
+
+After saving the file:
+
+- Open Settings → MCP Servers
+
+- Click Refresh MCP Servers
+
+Kilo Code will automatically detect and load the configuration.
+
+</details>
+
 <details>
 <summary><b>Install in Zed</b></summary>
 
@@ -857,10 +947,7 @@ For more information, see the [official GitHub documentation](https://docs.githu
       "headers": {
         "CONTEXT7_API_KEY": "YOUR_API_KEY"
       },
-      "tools": [
-        "get-library-docs", 
-        "resolve-library-id"
-      ]
+      "tools": ["get-library-docs", "resolve-library-id"]
     }
   }
 }
@@ -874,16 +961,8 @@ Or, for a local server:
     "context7": {
       "type": "local",
       "command": "npx",
-      "tools": [
-        "get-library-docs", 
-        "resolve-library-id"
-      ],
-      "args": [
-        "-y",
-        "@upstash/context7-mcp",
-        "--api-key",
-        "YOUR_API_KEY"
-      ]
+      "tools": ["get-library-docs", "resolve-library-id"],
+      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
     }
   }
 }
@@ -1190,23 +1269,7 @@ Context7 MCP provides the following tools that LLMs can use:
 
 ### Add a Rule
 
-If you don’t want to add `use context7` to every prompt, you can define a simple rule in your MCP client's rule section:
-
-- For Windsurf, in `.windsurfrules` file
-- For Cursor, from `Cursor Settings > Rules` section
-- For Claude Code, in `CLAUDE.md` file
-
-Or the equivalent in your MCP client to auto-invoke Context7 on any code question.
-
-#### Example Rule
-
-```txt
-Always use context7 when I need code generation, setup or configuration steps, or
-library/API documentation. This means you should automatically use the Context7 MCP
-tools to resolve library id and get library docs without me having to explicitly ask.
-```
-
-From then on, you’ll get Context7’s docs in any related conversation without typing anything extra. You can alter the rule to match your use cases.
+To avoid typing `use context7` in every prompt, you can add a rule to your MCP client that automatically invokes Context7 for code-related questions. See the [recommended setup in the Installation section](#️-installation) for detailed instructions and example rules.
 
 ### Use Library Id
 

package/dist/index.js

@@ -8,10 +8,8 @@ import express from "express";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { Command } from "commander";
 import { AsyncLocalStorage } from "async_hooks";
-/** Minimum allowed tokens for documentation retrieval */
-const MINIMUM_TOKENS = 1000;
-/** Default tokens when none specified */
-const DEFAULT_TOKENS = 5000;
+/** Default number of results to return per page */
+const DEFAULT_RESULTS_LIMIT = 10;
 /** Default HTTP server port */
 const DEFAULT_PORT = 3000;
 // Parse CLI arguments using commander
@@ -47,6 +45,8 @@ const CLI_PORT = (() => {
     return isNaN(parsed) ? undefined : parsed;
 })();
 const requestContext = new AsyncLocalStorage();
+// Store API key globally for stdio mode (where requestContext may not be available in tool handlers)
+let globalApiKey;
 function getClientIp(req) {
     const forwardedFor = req.headers["x-forwarded-for"] || req.headers["X-Forwarded-For"];
     if (forwardedFor) {
@@ -69,7 +69,7 @@ function getClientIp(req) {
 }
 const server = new McpServer({
     name: "Context7",
-    version: "1.0.27",
+    version: "1.0.28",
 }, {
     instructions: "Use this server to retrieve up-to-date documentation and code examples for any library.",
 });
@@ -127,7 +127,7 @@ Each result includes:
 - Benchmark Score: Quality indicator (100 is the highest score)
 - Versions: List of versions if available. Use one of those versions if the user provides a version in their query. The format of the version is /org/project/version.
 
-For best results, select libraries based on name match, source reputation, snippet coverage, and relevance to your use case.
+For best results, select libraries based on name match, source reputation, snippet coverage, benchmark score, and relevance to your use case.
 
 ----------
 
@@ -152,18 +152,21 @@ server.registerTool("get-library-docs", {
             .string()
             .optional()
             .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 < MINIMUM_TOKENS ? MINIMUM_TOKENS : val))
-            .optional()
-            .describe(`Maximum number of tokens of documentation to retrieve (default: ${DEFAULT_TOKENS}). Higher values provide more context but consume more tokens.`),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .describe("Page number for pagination (start: 1). If the context is not sufficient, try page=2, page=3, page=4, etc. with the same topic."),
     },
-}, async ({ context7CompatibleLibraryID, tokens = DEFAULT_TOKENS, topic = "" }) => {
+}, async ({ context7CompatibleLibraryID, page = 1, topic = "" }) => {
     const ctx = requestContext.getStore();
+    const apiKey = ctx?.apiKey || globalApiKey;
     const fetchDocsResponse = await fetchLibraryDocumentation(context7CompatibleLibraryID, {
-        tokens,
+        page,
+        limit: DEFAULT_RESULTS_LIMIT,
         topic,
-    }, ctx?.clientIp, ctx?.apiKey);
+    }, ctx?.clientIp, apiKey);
     if (!fetchDocsResponse) {
         return {
             content: [
@@ -283,6 +286,7 @@ async function main() {
     }
     else {
         const apiKey = cliOptions.apiKey || process.env.CONTEXT7_API_KEY;
+        globalApiKey = apiKey; // Store globally for tool handlers in stdio mode
         const transport = new StdioServerTransport();
         await requestContext.run({ apiKey }, async () => {
             await server.connect(transport);

package/dist/lib/api.js

@@ -84,9 +84,11 @@ export async function fetchLibraryDocumentation(libraryId, options = {}, clientI
         if (libraryId.startsWith("/")) {
             libraryId = libraryId.slice(1);
         }
-        const url = new URL(`${CONTEXT7_API_BASE_URL}/v1/${libraryId}`);
-        if (options.tokens)
-            url.searchParams.set("tokens", options.tokens.toString());
+        const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/docs/code/${libraryId}`);
+        if (options.page)
+            url.searchParams.set("page", options.page.toString());
+        if (options.limit)
+            url.searchParams.set("limit", options.limit.toString());
         if (options.topic)
             url.searchParams.set("topic", options.topic);
         url.searchParams.set("type", DEFAULT_TYPE);

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/context7-mcp","version":"1.0.27","mcpName":"io.github.upstash/context7","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-mcpb":"bun install && bun run build && rm -rf node_modules && bun install --production && 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"},"repository":{"type":"git","url":"git+https://github.com/upstash/context7.git"},"keywords":["modelcontextprotocol","mcp","context7","vibe-coding","developer tools","documentation","context"],"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.17.5","@types/express":"^5.0.4","commander":"^14.0.0","express":"^5.1.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"}}
+{"name":"@upstash/context7-mcp","version":"1.0.28","mcpName":"io.github.upstash/context7","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-mcpb":"bun install && bun run build && rm -rf node_modules && bun install --production && 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"},"repository":{"type":"git","url":"git+https://github.com/upstash/context7.git"},"keywords":["modelcontextprotocol","mcp","context7","vibe-coding","developer tools","documentation","context"],"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.17.5","@types/express":"^5.0.4","commander":"^14.0.0","express":"^5.1.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"}}