everything-mcp-server 0.0.0-stage → 0.2.0

package/src/server.js

@@ -0,0 +1,41 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { pathToFileURL } from 'node:url';
+import { readFileSync } from 'node:fs';
+import { AgentClient } from './agent.js';
+import { syntax } from './everything.js';
+import { compactSearch } from './compact.js';
+import { errorResult, requestsSchema, diagnosticSchema, searchOutputSchema, statusOutputSchema } from './schema.js';
+
+export const instructions = 'Search the selected Everything index. columns label row cells. When base is present, join it and relative row paths with a single / for absolute paths. Continue with next_offset and the same filters. Sizes are indexed logical bytes.';
+const { name, version = 'unreleased' } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+
+export function createServer(client = new AgentClient()) {
+  const server = new McpServer({ name, version }, { instructions });
+  const register = (name, description, inputSchema, outputSchema, handler) => server.registerTool(name, {
+    description, inputSchema, outputSchema,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  }, async (args, extra) => {
+    try {
+      const result = outputSchema.parse(await handler(args, extra.signal));
+      const failed = result.ready === false || result.results?.every(item => item.error);
+      return { content: [{ type: 'text', text: JSON.stringify(result) }], structuredContent: result, ...(failed ? { isError: true } : {}) };
+    } catch (error) {
+      return { content: [{ type: 'text', text: JSON.stringify(errorResult(error)) }], isError: true };
+    }
+  });
+
+  register('search', 'Find file/folder paths and indexed metadata across drives or within root. Use workspace search or rg for file contents. Submit 1–8 requests; recursive:false browses; count:0 counts; add kind:"file", fields:["size"] to sum matched bytes.', requestsSchema, searchOutputSchema, (args, signal) => compactSearch(client, args, signal));
+  register('status', 'Check connection status, selected instance, version, and index readiness.', diagnosticSchema, statusOutputSchema, (args, signal) => client.status(signal, args.verbose));
+  server.registerResource('everything-syntax', 'everything://syntax', { description: 'Query syntax and result semantics', mimeType: 'application/json' }, async uri => ({ contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(syntax) }] }));
+  return server;
+}
+
+export async function startServer() {
+  await createServer().connect(new StdioServerTransport());
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  try { await startServer(); }
+  catch (error) { console.error(JSON.stringify(errorResult(error))); process.exitCode = 1; }
+}

package/src/validation.js

@@ -0,0 +1,42 @@
+import { stat } from 'node:fs/promises';
+import { AgentError } from './schema.js';
+
+// Preserve quoted filename literals while identifying query functions.
+export function queryFunctions(query) {
+  const plain = query.replace(/"[^"]*"/g, ' ');
+  return [...plain.matchAll(/(?<![a-z0-9_-])\$?([a-z][a-z0-9_-]*):/gi)].map(match => match[1].toLowerCase());
+}
+
+export async function validateQuery(input) {
+  if (input.regex) return [];
+  const functions = queryFunctions(input.query);
+  for (const fn of functions) {
+    if (/content$/.test(fn) || ['include-filelist', 'include', 'filter', 'macro'].includes(fn)) {
+      throw new AgentError('UNSUPPORTED_QUERY', `Query function '${fn}:' is not supported in file path searches.`);
+    }
+    if (fn === 'regex') throw new AgentError('UNSUPPORTED_QUERY', 'Set regex:true and place the pattern in query.');
+    if (['sort', 'count', 'offset', 'distinct', 'unique'].includes(fn)) {
+      throw new AgentError('UNSUPPORTED_QUERY', `Query function '${fn}:' alters result semantics; use corresponding request parameters instead.`);
+    }
+  }
+  return functions;
+}
+
+export async function validateRoot(root, timeoutMs = 3000, signal) {
+  let timer;
+  const cleanup = new AbortController();
+  try {
+    const info = await Promise.race([
+      stat(root),
+      new Promise((_, reject) => { timer = setTimeout(() => reject(new AgentError('ROOT_CHECK_TIMEOUT', 'Root accessibility check timed out', true)), timeoutMs); }),
+      ...(signal ? [new Promise((_, reject) => {
+        if (signal.aborted) reject(new AgentError('CANCELLED', 'Request cancelled', true));
+        else signal.addEventListener('abort', () => reject(new AgentError('CANCELLED', 'Request cancelled', true)), { once: true, signal: cleanup.signal });
+      })] : []),
+    ]);
+    if (!info.isDirectory()) throw new AgentError('ROOT_NOT_DIRECTORY', 'Provide a directory as root');
+  } catch (error) {
+    if (error instanceof AgentError) throw error;
+    throw new AgentError(['ENOENT', 'ENOTDIR'].includes(error.code) ? 'ROOT_NOT_FOUND' : 'ROOT_INACCESSIBLE', 'Provide an accessible root directory', false, 'Check the root path spelling, availability, and permissions.');
+  } finally { clearTimeout(timer); cleanup.abort(); }
+}

package/vendor/es/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 voidtools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/es/manifest.json

@@ -0,0 +1,26 @@
+{
+  "version": "1.1.0.38",
+  "source": "https://github.com/voidtools/ES/tree/1.1.0.38",
+  "files": [
+    {
+      "path": "x64/es.exe",
+      "sha256": "f7378761cf6e01f51c4123a485e628d70e3fea147d341f473ce2820844e5cee5",
+      "source": "https://www.voidtools.com/ES-1.1.0.38.x64.zip"
+    },
+    {
+      "path": "x86/es.exe",
+      "sha256": "d3fef37ce9f25a44bb2898848b8eca0f44b0b22766b644c6e4e436b7f9d4b4fe",
+      "source": "https://www.voidtools.com/ES-1.1.0.38.x86.zip"
+    },
+    {
+      "path": "ARM64/es.exe",
+      "sha256": "7fc406610559f686a95a9bfc4472acffdebcc143b485ae9371b5ef4590e7ec31",
+      "source": "https://www.voidtools.com/ES-1.1.0.38.ARM64.zip"
+    },
+    {
+      "path": "ARM/es.exe",
+      "sha256": "7a0ebe57eecdc1c7ae227732020f3b14ad80a8cea78f4d91c35bb8d8e1eac11d",
+      "source": "https://www.voidtools.com/ES-1.1.0.38.ARM.zip"
+    }
+  ]
+}