@upstash/context7-mcp 1.0.9 → 1.0.10

package/README.md

@@ -61,7 +61,7 @@ Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file i
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -75,7 +75,7 @@ Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file i
   "mcpServers": {
     "context7": {
       "command": "bunx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -108,7 +108,7 @@ Add this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -127,7 +127,7 @@ Add this to your VS Code MCP config file. See [VS Code MCP docs](https://code.vi
     "Context7": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -143,7 +143,7 @@ It can be installed via [Zed Extensions](https://zed.dev/extensions?query=Contex
     "Context7": {
       "command": {
         "path": "npx",
-        "args": ["-y", "@upstash/context7-mcp@latest"]
+        "args": ["-y", "@upstash/context7-mcp"]
       },
       "settings": {}
     }
@@ -156,7 +156,7 @@ It can be installed via [Zed Extensions](https://zed.dev/extensions?query=Contex
 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.
 
 ```sh
-claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
+claude mcp add context7 -- npx -y @upstash/context7-mcp
 ```
 
 ### Install in Claude Desktop
@@ -168,7 +168,7 @@ Add this to your Claude Desktop `claude_desktop_config.json` file. See [Claude D
   "mcpServers": {
     "Context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -183,7 +183,7 @@ Open the "Settings" page of the app, navigate to "Plugins," and enter the follow
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -208,7 +208,7 @@ If you prefer to run the MCP server in a Docker container:
     WORKDIR /app
 
     # Install the latest version globally
-    RUN npm install -g @upstash/context7-mcp@latest
+    RUN npm install -g @upstash/context7-mcp
 
     # Expose default port if needed (optional, depends on MCP client interaction)
     # EXPOSE 3000
@@ -259,7 +259,7 @@ The configuration on Windows is slightly different compared to Linux or macOS (*
         "/c",
         "npx",
         "-y",
-        "@upstash/context7-mcp@latest"
+        "@upstash/context7-mcp"
       ],
       "disabled": false,
       "autoApprove": []
@@ -279,7 +279,7 @@ Examples:
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"],
+      "args": ["-y", "@upstash/context7-mcp"],
       "env": {
         "DEFAULT_MINIMUM_TOKENS": "10000"
       }
@@ -327,7 +327,7 @@ bun run build
 ### Testing with MCP Inspector
 
 ```bash
-npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest
+npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp
 ```
 
 ## Troubleshooting
@@ -341,7 +341,7 @@ If you see this error, try using `bunx` instead of `npx`.
   "mcpServers": {
     "context7": {
       "command": "bunx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -361,7 +361,26 @@ If you encounter an error like: `Error: Cannot find module 'uriTemplate.js'` try
       "args": [
         "-y",
         "--node-options=--experimental-vm-modules",
-        "@upstash/context7-mcp@1.0.6"
+        "@upstash/context7-mcp"
+      ]
+    }
+  }
+}
+```
+
+### TLS/Certificate Issues
+
+Use the `--experimental-fetch` flag with `npx` to bypass TLS-related issues:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--node-options=--experimental-fetch",
+        "@upstash/context7-mcp"
       ]
     }
   }
@@ -370,7 +389,7 @@ If you encounter an error like: `Error: Cannot find module 'uriTemplate.js'` try
 
 ### MCP Client Errors
 
-1. Try removing `@latest` from the package name.
+1. Try adding `@latest` to the package name.
 
 2. Try using `bunx` as an alternative.
 

package/dist/index.js

@@ -22,7 +22,7 @@ if (process.env.DEFAULT_MINIMUM_TOKENS) {
 const server = new McpServer({
     name: "Context7",
     description: "Retrieves up-to-date documentation and code examples for any library.",
-    version: "v1.0.9",
+    version: "v1.0.10",
     capabilities: {
         resources: {},
         tools: {},
@@ -31,7 +31,7 @@ const server = new McpServer({
 // Register Context7 tools
 server.tool("resolve-library-id", `Resolves a package/product name to a Context7-compatible library ID and returns a list of matching libraries.
 
-You MUST call this function before 'get-library-docs' to obtain a valid Context7-compatible library ID.
+You MUST call this function before 'get-library-docs' to obtain a valid Context7-compatible library ID UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.
 
 Selection Process:
 1. Analyze the query to understand what library/package the user is looking for
@@ -81,11 +81,12 @@ For ambiguous queries, request clarification before proceeding with a best-guess
                 text: `Available Libraries (top matches):
 
 Each result includes:
-- Library ID: Context7-compatible identifier (format: /org/repo)
+- Library ID: Context7-compatible identifier (format: /org/project)
 - Name: Library or package name
 - Description: Short summary
 - Code Snippets: Number of available code examples
 - Trust Score: Authority indicator
+- Versions: List of versions if available. Use one of those versions if and only if the user explicitly provides a version in their query.
 
 For best results, select libraries based on name match, trust score, snippet coverage, and relevance to your use case.
 
@@ -96,10 +97,10 @@ ${resultsText}`,
         ],
     };
 });
-server.tool("get-library-docs", "Fetches up-to-date documentation for a library. You must call 'resolve-library-id' first to obtain the exact Context7-compatible library ID required to use this tool.", {
+server.tool("get-library-docs", "Fetches up-to-date documentation for a library. You must call 'resolve-library-id' 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.", {
     context7CompatibleLibraryID: z
         .string()
-        .describe("Exact Context7-compatible library ID (e.g., 'mongodb/docs', 'vercel/nextjs') retrieved from 'resolve-library-id'."),
+        .describe("Exact Context7-compatible library ID (e.g., '/mongodb/docs', '/vercel/next.js', '/supabase/supabase', '/vercel/next.js/v14.3.0-canary.87') retrieved from 'resolve-library-id' or directly from user query in the format '/org/project' or '/org/project/version'."),
     topic: z
         .string()
         .optional()
@@ -110,18 +111,9 @@ server.tool("get-library-docs", "Fetches up-to-date documentation for a library.
         .optional()
         .describe(`Maximum number of tokens of documentation to retrieve (default: ${DEFAULT_MINIMUM_TOKENS}). Higher values provide more context but consume more tokens.`),
 }, async ({ context7CompatibleLibraryID, tokens = DEFAULT_MINIMUM_TOKENS, topic = "" }) => {
-    // Extract folders parameter if present in the ID
-    let folders = "";
-    let libraryId = context7CompatibleLibraryID;
-    if (context7CompatibleLibraryID.includes("?folders=")) {
-        const [id, foldersParam] = context7CompatibleLibraryID.split("?folders=");
-        libraryId = id;
-        folders = foldersParam;
-    }
-    const documentationText = await fetchLibraryDocumentation(libraryId, {
+    const documentationText = await fetchLibraryDocumentation(context7CompatibleLibraryID, {
         tokens,
         topic,
-        folders,
     });
     if (!documentationText) {
         return {

package/dist/lib/api.js

@@ -37,8 +37,6 @@ export async function fetchLibraryDocumentation(libraryId, options = {}) {
             url.searchParams.set("tokens", options.tokens.toString());
         if (options.topic)
             url.searchParams.set("topic", options.topic);
-        if (options.folders)
-            url.searchParams.set("folders", options.folders);
         url.searchParams.set("type", DEFAULT_TYPE);
         const response = await fetch(url, {
             headers: {

package/dist/lib/utils.js

@@ -20,6 +20,10 @@ export function formatSearchResult(result) {
     if (result.trustScore !== -1 && result.trustScore !== undefined) {
         formattedResult.push(`- Trust Score: ${result.trustScore}`);
     }
+    // Only add versions if it's a valid value
+    if (result.versions !== undefined && result.versions.length > 0) {
+        formattedResult.push(`- Versions: ${result.versions.join(", ")}`);
+    }
     // Join all parts with newlines
     return formattedResult.join("\n");
 }

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/context7-mcp","version":"v1.0.9","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"},"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.8.0","dotenv":"^16.5.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":"v1.0.10","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"},"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.8.0","dotenv":"^16.5.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"}}