@queryhere/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JeromeBillion
+
+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/README.md

@@ -0,0 +1,60 @@
+# Query Here MCP Server
+
+Model Context Protocol (MCP) server that gives Claude Desktop, Cursor, and other MCP clients access to Query Here search.
+
+## Install (users)
+
+Add to your MCP config (`claude_desktop_config.json` or Cursor MCP settings):
+
+```json
+{
+  "mcpServers": {
+    "queryhere": {
+      "command": "npx",
+      "args": ["-y", "@queryhere/mcp-server"],
+      "env": {
+        "QUERY_HERE_API_KEY": "qh_live_..."
+      }
+    }
+  }
+}
+```
+
+Create a free API key at [queryhere.com](https://www.queryhere.com).
+
+### Environment variables
+
+| Variable | Required | Default |
+| --- | --- | --- |
+| `QUERY_HERE_API_KEY` | Yes | — |
+| `QUERY_HERE_API_URL` | No | `https://api.queryhere.com` |
+| `QUERY_HERE_TIMEOUT_MS` | No | `30000` |
+
+## Local development
+
+```powershell
+cd mcp
+npm install
+npm run build
+$env:QUERY_HERE_API_KEY="qh_live_..."
+$env:QUERY_HERE_API_URL="http://localhost:3000"
+npm start
+```
+
+## Publish checklist (maintainers)
+
+```powershell
+cd mcp
+npm whoami
+npm run build
+npm pack --dry-run
+npm publish --access public
+```
+
+Verify after publish:
+
+```powershell
+npx -y @queryhere/mcp-server
+```
+
+The server expects stdio MCP transport and will exit immediately if `QUERY_HERE_API_KEY` is not set.

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+const QUERY_HERE_API_KEY = process.env.QUERY_HERE_API_KEY;
+const QUERY_HERE_API_URL = process.env.QUERY_HERE_API_URL || "https://api.queryhere.com";
+const QUERY_HERE_TIMEOUT_MS = Number(process.env.QUERY_HERE_TIMEOUT_MS || 30000);
+if (!QUERY_HERE_API_KEY) {
+    console.error("Error: QUERY_HERE_API_KEY environment variable is required");
+    process.exit(1);
+}
+let API_URL;
+try {
+    const parsedApiUrl = new URL(QUERY_HERE_API_URL);
+    if (parsedApiUrl.protocol !== "https:" && parsedApiUrl.protocol !== "http:") {
+        throw new Error("QUERY_HERE_API_URL must use http or https");
+    }
+    API_URL = parsedApiUrl.toString().replace(/\/$/, "");
+}
+catch (error) {
+    console.error(`Error: invalid QUERY_HERE_API_URL: ${error.message}`);
+    process.exit(1);
+}
+if (!Number.isFinite(QUERY_HERE_TIMEOUT_MS) || QUERY_HERE_TIMEOUT_MS < 1000) {
+    console.error("Error: QUERY_HERE_TIMEOUT_MS must be a number greater than or equal to 1000");
+    process.exit(1);
+}
+const searchArgumentsSchema = z.object({
+    query: z.string().trim().min(3).max(240),
+    mode: z.enum(["hybrid", "catalog_only", "live_only"]).default("hybrid"),
+    limit: z.coerce.number().int().min(1).max(50).default(10),
+});
+const server = new Server({
+    name: "queryhere-search",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Define the single tool
+const SEARCH_TOOL = {
+    name: "search_query_here",
+    description: "Searches the web and the Query Here registry for actionable APIs, CLIs, MCP servers, and websites. Use this to find external capabilities and tools that you can integrate with or direct the user to.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The natural language search query (e.g., 'find an MCP server for browser automation' or 'book a flight').",
+            },
+            mode: {
+                type: "string",
+                enum: ["hybrid", "catalog_only", "live_only"],
+                default: "hybrid",
+                description: "Search mode to use. Hybrid is recommended for broad discovery.",
+            },
+            limit: {
+                type: "number",
+                minimum: 1,
+                maximum: 50,
+                default: 10,
+                description: "Maximum number of results to return (default: 10).",
+            },
+        },
+        required: ["query"],
+    },
+};
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [SEARCH_TOOL],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name !== "search_query_here") {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+    const parsedArguments = searchArgumentsSchema.safeParse(request.params.arguments ?? {});
+    if (!parsedArguments.success) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Invalid search_query_here arguments: ${JSON.stringify(parsedArguments.error.flatten(), null, 2)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { query, mode, limit } = parsedArguments.data;
+    try {
+        const response = await fetch(`${API_URL}/v1/search`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": QUERY_HERE_API_KEY,
+                "User-Agent": "QueryHere-MCP-Server/1.0",
+            },
+            body: JSON.stringify({
+                query,
+                mode,
+                limit,
+            }),
+            signal: AbortSignal.timeout(QUERY_HERE_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Search API failed with status ${response.status}: ${errorText}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const data = await response.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `An error occurred during search: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function run() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Query Here MCP Server running on stdio");
+}
+run().catch((error) => {
+    console.error("Fatal error running server:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@queryhere/mcp-server",
+  "version": "1.0.0",
+  "description": "An MCP Server for searching the Query Here registry and the live web for actionable AI tools.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "queryhere-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.16",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "keywords": [
+    "queryhere",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "service-discovery",
+    "cursor",
+    "claude-desktop"
+  ],
+  "homepage": "https://www.queryhere.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JeromeBillion/QueryHere.com.git",
+    "directory": "mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/JeromeBillion/QueryHere.com/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}