@comunica/mcp-sparql-file 1.0.0 → 1.1.0

package/README.md

@@ -218,6 +218,36 @@ possibly combined with a reverse proxy and/or OAuth layer.
 $ comunica-mcp-sparql-file --mode http --port 3123
 ```
 
+## Query timeouts
+
+SPARQL queries can take arbitrarily long, for example when they are executed over large or slow sources.
+To make sure that an agent never waits indefinitely, queries are aborted after `--timeout` milliseconds
+(60 seconds by default, `--timeout 0` disables this), after which the agent receives an error
+that invites it to refine its query.
+
+```bash
+$ comunica-mcp-sparql-file --mode http --port 3123 --timeout 300000
+```
+
+Comunica offers no way to abort a query that is already running,
+so a timed out query would keep consuming CPU and memory in the background.
+In http mode, queries are therefore executed inside worker processes that are supervised by a primary process,
+which allows such workers to be replaced by a fresh one after a timeout.
+This also makes the server recover from queries that block the event loop entirely,
+which would otherwise make the server unreachable forever.
+
+The number of workers can be configured with `--workers`, which also determines
+how many queries can be executed concurrently:
+
+```bash
+$ comunica-mcp-sparql-file --mode http --port 3123 --workers 4
+```
+
+In stdio mode, the server always runs as a single process, since worker processes can not share a single
+standard input stream, and replacing a worker would invalidate the MCP session of the connected client.
+Queries are still aborted after `--timeout` milliseconds there, but their resources are only reclaimed
+once the query terminates by itself.
+
 ## Available Tools
 
 This MCP server provides the following tools:

package/bin/mcp.js

@@ -4,5 +4,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const query_sparql_file_1 = require("@comunica/query-sparql-file");
 const utils_mcp_1 = require("@comunica/utils-mcp");
 // eslint-disable-next-line ts/no-require-imports,ts/no-var-requires,import/extensions
-(0, utils_mcp_1.runCli)(new query_sparql_file_1.QueryEngine(), require('../package.json').version);
+(0, utils_mcp_1.runCli)(() => new query_sparql_file_1.QueryEngine(), require('../package.json').version);
 //# sourceMappingURL=mcp.js.map

package/bin/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["mcp.ts"],"names":[],"mappings":";;;AACA,mEAA0D;AAC1D,mDAA6C;AAE7C,sFAAsF;AACtF,IAAA,kBAAM,EAAC,IAAI,+BAAW,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { QueryEngine } from '@comunica/query-sparql-file';\nimport { runCli } from '@comunica/utils-mcp';\n\n// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires,import/extensions\nrunCli(new QueryEngine(), require('../package.json').version);\n"]}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["mcp.ts"],"names":[],"mappings":";;;AACA,mEAA0D;AAC1D,mDAA6C;AAE7C,sFAAsF;AACtF,IAAA,kBAAM,EAAC,GAAG,EAAE,CAAC,IAAI,+BAAW,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { QueryEngine } from '@comunica/query-sparql-file';\nimport { runCli } from '@comunica/utils-mcp';\n\n// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires,import/extensions\nrunCli(() => new QueryEngine(), require('../package.json').version);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comunica/mcp-sparql-file",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "An MCP server for executing SPARQL queries over local and remote RDF files",
   "license": "MIT",
   "funding": {
@@ -54,7 +54,7 @@
   },
   "dependencies": {
     "@comunica/query-sparql-file": "^5.1.3",
-    "@comunica/utils-mcp": "^1.0.0"
+    "@comunica/utils-mcp": "^1.1.0"
   },
-  "gitHead": "8a35a73d61cf1066bb1181761884d84d3b932932"
+  "gitHead": "4d3c6e5233ec89ceeb45bd2a478652e7f74d5cd2"
 }