@upstash/context7-mcp 1.0.7 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,7 +2,8 @@
2
2
 
3
3
  [![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) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)
4
4
 
5
- [![中文文档](https://img.shields.io/badge/docs-中文版-yellow)](./docs/README.zh-CN.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./docs/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./docs/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./docs/README.fr.md) [![Documentação em Português (Brasil)](https://img.shields.io/badge/docs-Português%20(Brasil)-purple)](./docs/README.pt-BR.md) [![Documentazione in italiano](https://img.shields.io/badge/docs-Italian-red)](./docs/README.it.md) [![Dokumentasi Bahasa Indonesia](https://img.shields.io/badge/docs-Bahasa%20Indonesia-pink)](./docs/README.id-ID.md) [![Dokumentation auf Deutsch](https://img.shields.io/badge/docs-Deutsch-darkgreen)](./docs/README.de.md) [![Документация на русском языке](https://img.shields.io/badge/docs-Русский-darkblue)](./docs/README.ru.md)
5
+ [![中文文档](https://img.shields.io/badge/docs-中文版-yellow)](./docs/README.zh-CN.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./docs/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./docs/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./docs/README.fr.md) [![Documentação em Português (Brasil)](https://img.shields.io/badge/docs-Português%20(Brasil)-purple)](./docs/README.pt-BR.md) [![Documentazione in italiano](https://img.shields.io/badge/docs-Italian-red)](./docs/README.it.md) [![Dokumentasi Bahasa Indonesia](https://img.shields.io/badge/docs-Bahasa%20Indonesia-pink)](./docs/README.id-ID.md) [![Dokumentation auf Deutsch](https://img.shields.io/badge/docs-Deutsch-darkgreen)](./docs/README.de.md) [![Документация на русском языке](https://img.shields.io/badge/docs-Русский-darkblue)](./docs/README.ru.md) [![Türkçe Doküman](https://img.shields.io/badge/docs-Türkçe-blue)](./docs/README.tr.md)
6
+
6
7
 
7
8
  ## ❌ Without Context7
8
9
 
@@ -90,7 +91,7 @@ Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file i
90
91
  "mcpServers": {
91
92
  "context7": {
92
93
  "command": "deno",
93
- "args": ["run", "--allow-net", "npm:@upstash/context7-mcp"]
94
+ "args": ["run", "--allow-env", "--allow-net", "npm:@upstash/context7-mcp"]
94
95
  }
95
96
  }
96
97
  }
@@ -173,6 +174,23 @@ Add this to your Claude Desktop `claude_desktop_config.json` file. See [Claude D
173
174
  }
174
175
  ```
175
176
 
177
+ ### Install in BoltAI
178
+
179
+ Open the "Settings" page of the app, navigate to "Plugins," and enter the following JSON:
180
+
181
+ ```json
182
+ {
183
+ "mcpServers": {
184
+ "context7": {
185
+ "args": ["-y", "@upstash/context7-mcp@latest"],
186
+ "command": "npx"
187
+ }
188
+ }
189
+ }
190
+ ```
191
+
192
+ Once saved, enter in the chat `get-library-docs` followed by your Context7 documentation ID (e.g., `get-library-docs /nuxt/ui`). More information is available on [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers). For BoltAI on iOS, [see this guide](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).
193
+
176
194
  ### Using Docker
177
195
 
178
196
  If you prefer to run the MCP server in a Docker container:
@@ -230,6 +248,26 @@ If you prefer to run the MCP server in a Docker container:
230
248
 
231
249
  *Note: This is an example configuration. Please refer to the specific examples for your MCP client (like Cursor, VS Code, etc.) earlier in this README to adapt the structure (e.g., `mcpServers` vs `servers`). Also, ensure the image name in `args` matches the tag used during the `docker build` command.*
232
250
 
251
+ ### Install in Windows
252
+ The configuration on Windows is slightly different compared to Linux or macOS (*`Cline` is used in the example*). The same principle applies to other editors; refer to the configuration of `command` and `args`.
253
+ ```json
254
+ {
255
+ "mcpServers": {
256
+ "github.com/upstash/context7-mcp": {
257
+ "command": "cmd",
258
+ "args": [
259
+ "/c",
260
+ "npx",
261
+ "-y",
262
+ "@upstash/context7-mcp@latest"
263
+ ],
264
+ "disabled": false,
265
+ "autoApprove": []
266
+ }
267
+ }
268
+ }
269
+ ```
270
+
233
271
  ### Environment Variables
234
272
 
235
273
  - `DEFAULT_MINIMUM_TOKENS`: Set the minimum token count for documentation retrieval (default: 10000).
package/dist/index.js CHANGED
@@ -22,7 +22,7 @@ if (process.env.DEFAULT_MINIMUM_TOKENS) {
22
22
  const server = new McpServer({
23
23
  name: "Context7",
24
24
  description: "Retrieves up-to-date documentation and code examples for any library.",
25
- version: "v1.0.7",
25
+ version: "v1.0.8",
26
26
  capabilities: {
27
27
  resources: {},
28
28
  tools: {},
package/dist/lib/utils.js CHANGED
@@ -1,19 +1,34 @@
1
1
  /**
2
- * Format a search result into a string representation
3
- * @param result SearchResult to format
4
- * @returns Formatted search result string
2
+ * Formats a search result into a human-readable string representation.
3
+ * Only shows code snippet count and GitHub stars when available (not equal to -1).
4
+ *
5
+ * @param result The SearchResult object to format
6
+ * @returns A formatted string with library information
5
7
  */
6
8
  export function formatSearchResult(result) {
7
- return `- Title: ${result.title}
8
- - Context7-compatible library ID: ${result.id}
9
- - Description: ${result.description}
10
- - Code Snippets: ${result.totalSnippets}
11
- - GitHub Stars: ${result.stars}`;
9
+ // Always include these basic details
10
+ const formattedResult = [
11
+ `- Title: ${result.title}`,
12
+ `- Context7-compatible library ID: ${result.id}`,
13
+ `- Description: ${result.description}`,
14
+ ];
15
+ // Only add code snippets count if it's a valid value
16
+ if (result.totalSnippets !== -1 && result.totalSnippets !== undefined) {
17
+ formattedResult.push(`- Code Snippets: ${result.totalSnippets}`);
18
+ }
19
+ // Only add GitHub stars if it's a valid value
20
+ if (result.stars !== -1 && result.stars !== undefined) {
21
+ formattedResult.push(`- GitHub Stars: ${result.stars}`);
22
+ }
23
+ // Join all parts with newlines
24
+ return formattedResult.join("\n");
12
25
  }
13
26
  /**
14
- * Format search results into a string representation
15
- * @param searchResponse The search response to format
16
- * @returns Formatted search results string
27
+ * Formats a search response into a human-readable string representation.
28
+ * Each result is formatted using formatSearchResult.
29
+ *
30
+ * @param searchResponse The SearchResponse object to format
31
+ * @returns A formatted string with search results
17
32
  */
18
33
  export function formatSearchResults(searchResponse) {
19
34
  if (!searchResponse.results || searchResponse.results.length === 0) {
package/package.json CHANGED
@@ -1 +1 @@
1
- {"name":"@upstash/context7-mcp","version":"v1.0.7","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"}}
1
+ {"name":"@upstash/context7-mcp","version":"v1.0.8","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"}}