@upstash/context7-mcp 1.0.2 → 1.0.4

package/README.md

@@ -52,7 +52,7 @@ Paste this into your Cursor `~/.cursor/mcp.json` file. See [Cursor MCP docs](htt
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
+      "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
@@ -67,7 +67,23 @@ Add this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    }
+  }
+}
+```
+
+### Install in VSCode
+
+Add this to your VSCode MCP config file. See [VSCode MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info.
+
+```json
+{
+  "servers": {
+    "Context7": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
@@ -112,7 +128,7 @@ bun run build
 ### Testing with MCP Inspector
 
 ```bash
-npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp
+npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest
 ```
 
 ## License

package/dist/index.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+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";
+const DEFAULT_MINIMUM_TOKENS = 5000;
+// Create server instance
+const server = new McpServer({
+    name: "Context7",
+    description: "Retrieves up-to-date documentation and code examples for any library.",
+    version: "1.0.4",
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+// Register Context7 tools
+server.tool("resolve-library-id", "Required first step: Resolves a general package name into a Context7-compatible library ID. Must be called before using 'get-library-docs' to retrieve a valid Context7-compatible library ID.", {
+    libraryName: z
+        .string()
+        .optional()
+        .describe("Optional library name to search for and rerank results based on."),
+}, async ({ libraryName }) => {
+    const searchResponse = await searchLibraries(libraryName || "");
+    if (!searchResponse || !searchResponse.results) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to retrieve library documentation data from Context7",
+                },
+            ],
+        };
+    }
+    if (searchResponse.results.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No documentation libraries available",
+                },
+            ],
+        };
+    }
+    const resultsText = formatSearchResults(searchResponse);
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Available libraries and their Context7-compatible library IDs:\n\n" + 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.", {
+    context7CompatibleLibraryID: z
+        .string()
+        .describe("Exact Context7-compatible library ID (e.g., 'mongodb/docs', 'vercel/nextjs') retrieved from 'resolve-library-id'."),
+    topic: z
+        .string()
+        .optional()
+        .describe("Topic to focus documentation on (e.g., 'hooks', 'routing')."),
+    tokens: z
+        .number()
+        .min(DEFAULT_MINIMUM_TOKENS)
+        .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, {
+        tokens,
+        topic,
+        folders,
+    });
+    if (!documentationText) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Documentation not found or not finalized for this library. This might have happened because you used an invalid Context7-compatible library ID. To get a valid Context7-compatible library ID, use the 'resolve-library-id' with the package name you wish to retrieve documentation for.",
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: documentationText,
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Context7 Documentation MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/dist/lib/api.js

@@ -0,0 +1,62 @@
+const CONTEXT7_API_BASE_URL = "https://context7.com/api";
+const DEFAULT_TYPE = "txt";
+/**
+ * Searches for libraries matching the given query
+ * @param query The search query
+ * @returns Search results or null if the request fails
+ */
+export async function searchLibraries(query) {
+    try {
+        const url = new URL(`${CONTEXT7_API_BASE_URL}/v1/search`);
+        url.searchParams.set("query", query);
+        const response = await fetch(url);
+        if (!response.ok) {
+            console.error(`Failed to search libraries: ${response.status}`);
+            return null;
+        }
+        return await response.json();
+    }
+    catch (error) {
+        console.error("Error searching libraries:", error);
+        return null;
+    }
+}
+/**
+ * Fetches documentation context for a specific library
+ * @param libraryId The library ID to fetch documentation for
+ * @param options Options for the request
+ * @returns The documentation text or null if the request fails
+ */
+export async function fetchLibraryDocumentation(libraryId, options = {}) {
+    try {
+        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());
+        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: {
+                "X-Context7-Source": "mcp-server",
+            },
+        });
+        if (!response.ok) {
+            console.error(`Failed to fetch documentation: ${response.status}`);
+            return null;
+        }
+        const text = await response.text();
+        if (!text || text === "No content available" || text === "No context data available") {
+            return null;
+        }
+        return text;
+    }
+    catch (error) {
+        console.error("Error fetching library documentation:", error);
+        return null;
+    }
+}

package/dist/lib/types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/utils.js

@@ -0,0 +1,20 @@
+/**
+ * Format a search result into a string representation
+ * @param result SearchResult to format
+ * @returns Formatted search result string
+ */
+export function formatSearchResult(result) {
+    return `Title: ${result.title}\n\nContext7-compatible library ID: ${result.id}`;
+}
+/**
+ * Format search results into a string representation
+ * @param searchResponse The search response to format
+ * @returns Formatted search results string
+ */
+export function formatSearchResults(searchResponse) {
+    if (!searchResponse.results || searchResponse.results.length === 0) {
+        return "No documentation libraries found matching your query.";
+    }
+    const formattedResults = searchResponse.results.map(formatSearchResult);
+    return formattedResults.join("\n\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/context7-mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "MCP server for Context7",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",