@upstash/context7-mcp 1.0.13 → 1.0.14

package/README.md

@@ -203,6 +203,45 @@ Add this to your VS Code MCP config file. See [VS Code MCP docs](https://code.vi
 
 </details>
 
+<details>
+<summary><b>Install in Visual Studio 2022</b></summary>
+
+You can configure Context7 MCP in Visual Studio 2022 by following the [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).
+
+Add this to your Visual Studio MCP config file (see the [Visual Studio docs](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) for details):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "context7": {
+        "type": "http",
+        "url": "https://mcp.context7.com/mcp"
+      }
+    }
+  }
+}
+```
+
+Or, for a local server:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "context7": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@upstash/context7-mcp"]
+      }
+    }
+  }
+}
+```
+
+For more information and troubleshooting, refer to the [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).
+</details>
+
 <details>
 <summary><b>Install in Zed</b></summary>
 
@@ -420,27 +459,46 @@ Add this to your Roo Code MCP configuration file. See [Roo Code MCP docs](https:
 
 </details>
 
-## 🔧 Environment Variables
+<details>
+<summary><b>Install in Zencoder</b></summary>
 
-The Context7 MCP server supports the following environment variables:
+To configure Context7 MCP in Zencoder, follow these steps:
 
-- `DEFAULT_MINIMUM_TOKENS`: Set the minimum token count for documentation retrieval (default: 10000)
+1. Go to the Zencoder menu (...)
+2. From the dropdown menu, select Agent tools
+3. Click on the Add custom MCP
+4. Add the name and server configuration from below, and make sure to hit the Install button
 
-Example configuration with environment variables:
+```json
+{
+    "command": "npx",
+    "args": [
+        "-y",
+        "@upstash/context7-mcp@latest"
+    ]
+}
+```
+
+Once the MCP server is added, you can easily continue using it.
+
+</details>
+
+<details>
+<summary><b>Install in Amazon Q Developer CLI</b></summary>
+
+Add this to your Amazon Q Developer CLI configuration file. See [Amazon Q Developer CLI docs](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) for more details.
 
 ```json
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"],
-      "env": {
-        "DEFAULT_MINIMUM_TOKENS": "6000"
-      }
+      "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
 ```
+</details>
 
 ## 🔨 Available Tools
 
@@ -453,7 +511,7 @@ Context7 MCP provides the following tools that LLMs can use:
 - `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 configured `DEFAULT_MINIMUM_TOKENS` value or the default value of 10000 are automatically increased to that value.
+  - `tokens` (optional, default 10000): Max number of tokens to return. Values less than the default value of 10000 are automatically increased to 10000.
 
 ## 💻 Development
 
@@ -469,6 +527,25 @@ Build:
 bun run build
 ```
 
+Run the server:
+
+```bash
+bun run dist/index.js
+```
+
+### CLI Arguments
+
+`context7-mcp` accepts the following CLI flags:
+
+- `--transport <stdio|http|sse>` – Transport to use (`stdio` by default).
+- `--port <number>` – Port to listen on when using `http` or `sse` transport (default `3000`).
+
+Example with http transport and port 8080:
+
+```bash
+bun run dist/index.js --transport http --port 8080
+```
+
 <details>
 <summary><b>Local Configuration Example</b></summary>
 

package/dist/index.js

@@ -4,36 +4,40 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { searchLibraries, fetchLibraryDocumentation } from "./lib/api.js";
 import { formatSearchResults } from "./lib/utils.js";
-import dotenv from "dotenv";
 import { createServer } from "http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
-import { parse } from "url";
-// Load environment variables from .env file if present
-dotenv.config();
-// Get DEFAULT_MINIMUM_TOKENS from environment variable or use default
-let DEFAULT_MINIMUM_TOKENS = 10000;
-if (process.env.DEFAULT_MINIMUM_TOKENS) {
-    const parsedValue = parseInt(process.env.DEFAULT_MINIMUM_TOKENS, 10);
-    if (!isNaN(parsedValue) && parsedValue > 0) {
-        DEFAULT_MINIMUM_TOKENS = parsedValue;
-    }
-    else {
-        console.warn(`Warning: Invalid DEFAULT_MINIMUM_TOKENS value provided in environment variable. Using default value of 10000`);
-    }
+import { Command } from "commander";
+const DEFAULT_MINIMUM_TOKENS = 10000;
+// Parse CLI arguments using commander
+const program = new Command()
+    .option("--transport <stdio|http|sse>", "transport type", "stdio")
+    .option("--port <number>", "port for HTTP/SSE transport", "3000")
+    .allowUnknownOption() // let MCP Inspector / other wrappers pass through extra flags
+    .parse(process.argv);
+const cliOptions = program.opts();
+// Validate transport option
+const allowedTransports = ["stdio", "http", "sse"];
+if (!allowedTransports.includes(cliOptions.transport)) {
+    console.error(`Invalid --transport value: '${cliOptions.transport}'. Must be one of: stdio, http, sse.`);
+    process.exit(1);
 }
+// Transport configuration
+const TRANSPORT_TYPE = (cliOptions.transport || "stdio");
+// HTTP/SSE port configuration
+const CLI_PORT = (() => {
+    const parsed = parseInt(cliOptions.port, 10);
+    return isNaN(parsed) ? undefined : parsed;
+})();
 // Store SSE transports by session ID
 const sseTransports = {};
 // Function to create a new server instance with all tools registered
 function createServerInstance() {
     const server = new McpServer({
         name: "Context7",
-        description: "Retrieves up-to-date documentation and code examples for any library.",
-        version: "v1.0.13",
-        capabilities: {
-            resources: {},
-            tools: {},
-        },
+        version: "v1.0.14",
+    }, {
+        instructions: "Use this server to retrieve up-to-date documentation and code examples for any library.",
     });
     // 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.
@@ -136,14 +140,14 @@ ${resultsText}`,
     return server;
 }
 async function main() {
-    const transportType = process.env.MCP_TRANSPORT || "stdio";
+    const transportType = TRANSPORT_TYPE;
     if (transportType === "http" || transportType === "sse") {
         // Get initial port from environment or use default
-        const initialPort = process.env.PORT ? parseInt(process.env.PORT, 10) : 3000;
+        const initialPort = CLI_PORT ?? 3000;
         // Keep track of which port we end up using
         let actualPort = initialPort;
         const httpServer = createServer(async (req, res) => {
-            const url = parse(req.url || "").pathname;
+            const url = new URL(req.url || "", `http://${req.headers.host}`).pathname;
             // Set CORS headers for all responses
             res.setHeader("Access-Control-Allow-Origin", "*");
             res.setHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS,DELETE");
@@ -177,8 +181,8 @@ async function main() {
                 }
                 else if (url === "/messages" && req.method === "POST") {
                     // Get session ID from query parameters
-                    const parsedUrl = parse(req.url || "", true);
-                    const sessionId = parsedUrl.query.sessionId;
+                    const sessionId = new URL(req.url || "", `http://${req.headers.host}`).searchParams.get("sessionId") ??
+                        "";
                     if (!sessionId) {
                         res.writeHead(400);
                         res.end("Missing sessionId parameter");

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/context7-mcp","version":"v1.0.13","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":"MCP_TRANSPORT=http node dist/index.js"},"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.12.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.14","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"},"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.12.0","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"}}