@bedolla/enriweb 0.1.0

package/README.md

@@ -0,0 +1,182 @@
+# EnriWeb
+
+EnriWeb is a **Model Context Protocol (MCP)** server over `stdio` that exposes **web search** and **URL fetching** tools by delegating execution to **EnriProxy**.
+
+If your MCP client can call MCP tools, it can do web search / fetch in a consistent way without implementing provider-specific scraping logic.
+
+## What this project is
+
+- An MCP server process your MCP host launches (OpenCode, Claude Code, Codex, etc.)
+- A thin client for EnriProxy (input validation + structured output)
+
+## Requirements
+
+- Node.js `>= 22` (recommended: Node 24 LTS)
+- A reachable EnriProxy server with:
+  - `POST /v1/tools/web_search`
+  - `POST /v1/tools/web_fetch`
+- An EnriProxy API key (configured on the EnriProxy side)
+
+## Install
+
+```powershell
+# Global install
+npm install -g @bedolla/enriweb
+
+# Or run without installing
+npx -y @bedolla/enriweb@latest --help
+```
+
+## Build
+
+```powershell
+npm install
+npm run typecheck
+npm run build
+```
+
+## Usage
+
+### 1) Configure your MCP host
+
+EnriWeb runs as an MCP server over `stdio`. Your MCP host is responsible for launching the process.
+
+Example: global install
+
+```jsonc
+{
+  "EnriWeb": {
+    "type": "stdio",
+    "command": "enriweb",
+    "args": [],
+    "env": {
+      "ENRIPROXY_URL": "http://127.0.0.1:8787",
+      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY"
+    }
+  }
+}
+```
+
+Example: no install (always uses whatever npm currently tags as `latest`)
+
+```jsonc
+{
+  "EnriWeb": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@bedolla/enriweb@latest"],
+    "env": {
+      "ENRIPROXY_URL": "http://127.0.0.1:8787",
+      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY"
+    }
+  }
+}
+```
+
+<details>
+<summary>Use a local dev checkout</summary>
+
+```jsonc
+{
+  "EnriWeb": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["C:\\\\Users\\\\Administrator\\\\Projects\\\\EnriWeb\\\\dist\\\\index.js"],
+    "env": {
+      "ENRIPROXY_URL": "http://127.0.0.1:8787",
+      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY"
+    }
+  }
+}
+```
+
+</details>
+
+## Configuration
+
+EnriWeb is configured via environment variables:
+
+- `ENRIPROXY_URL` (`string`, optional, default: `http://127.0.0.1:8787`)
+- `ENRIPROXY_API_KEY` (`string`, required)
+- `ENRIWEB_TIMEOUT_MS` (`string`, optional, default: `60000`)
+  - Parsed as an integer (milliseconds).
+- `ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS` (`string`, optional, default: `200000`)
+  - Parsed as an integer.
+- `ENRIWEB_GITHUB_TOKEN` (`string`, optional)
+  - Used for GitHub API enrichment to improve rate limits.
+
+## MCP tools
+
+EnriWeb exposes these MCP tools:
+
+- `web_search`
+- `web_fetch`
+
+<details>
+<summary>Tool inputs (option-by-option)</summary>
+
+General notes:
+
+- All tools accept a single JSON object as their input (the MCP `arguments` for that tool).
+- EnriWeb returns both:
+  - a short human-readable preview (`content`)
+  - the full result payload (`structuredContent`)
+
+---
+
+### `web_search`
+
+Search the web via EnriProxy.
+
+Inputs:
+
+- `query` (`string`, required): search query string.
+- `max_results` (`number`, optional)
+  - Must be `>= 1`.
+  - If omitted, EnriProxy uses its configured default.
+  - The upper limit is enforced server-side (EnriWeb does not hardcode a max).
+- `recency` (`string`, optional, default: `noLimit`)
+  - One of: `oneDay` | `oneWeek` | `oneMonth` | `oneYear` | `noLimit`
+- `allowed_domains` (`string[]`, optional): allowlist of domains to include.
+- `blocked_domains` (`string[]`, optional): blocklist of domains to exclude.
+- `search_prompt` (`string`, optional): extra context to refine the search intent.
+
+Example `arguments` object:
+
+```jsonc
+{
+  "query": "qdrant docker compose autostart systemd",
+  "max_results": 10,
+  "recency": "oneMonth"
+}
+```
+
+---
+
+### `web_fetch`
+
+Fetch and read content from a URL via EnriProxy.
+
+Inputs:
+
+- `url` (`string`, required unless `cursor` is provided): full URL (`http://` or `https://`).
+- `cursor` (`string`, optional): opaque cursor returned by a previous `web_fetch` call.
+- `offset` (`number`, optional, default: `0`): cursor read offset in characters.
+- `limit` (`number`, optional): cursor read limit in characters (default: `max_chars`).
+- `prompt` (`string`, optional): extraction hint (what to focus on).
+- `max_chars` (`number`, optional): maximum content length (default: `ENRIWEB_WEB_FETCH_DEFAULT_MAX_CHARS`).
+
+Notes:
+
+- If the response includes a `cursor`, you can page through the captured content by calling `web_fetch` again with `cursor` + `offset` + `limit`.
+
+Example `arguments` object:
+
+```jsonc
+{
+  "url": "https://example.com/docs",
+  "max_chars": 200000
+}
+```
+
+</details>

package/dist/client/EnriProxyClient.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Connection configuration for {@link EnriProxyClient}.
+ */
+export interface EnriProxyClientConfig {
+    /**
+     * EnriProxy base URL (e.g., https://proxy.example.com).
+     */
+    readonly baseUrl: string;
+    /**
+     * EnriProxy API key (sent as Authorization: Bearer ...).
+     */
+    readonly apiKey: string;
+    /**
+     * Default request timeout in milliseconds.
+     */
+    readonly timeoutMs: number;
+}
+/**
+ * Web search request parameters.
+ */
+export interface WebSearchRequest {
+    /**
+     * Search query string.
+     */
+    readonly query: string;
+    /**
+     * Maximum number of results.
+     */
+    readonly maxResults?: number;
+    /**
+     * Recency filter.
+     */
+    readonly recency?: string;
+    /**
+     * Allowed domains filter.
+     */
+    readonly allowedDomains?: string[];
+    /**
+     * Blocked domains filter.
+     */
+    readonly blockedDomains?: string[];
+    /**
+     * Optional search prompt context.
+     */
+    readonly searchPrompt?: string;
+}
+/**
+ * Web search result entry.
+ */
+export interface WebSearchResultEntry {
+    /**
+     * Result URL.
+     */
+    readonly url: string;
+    /**
+     * Result title.
+     */
+    readonly title?: string;
+    /**
+     * Result snippet.
+     */
+    readonly snippet?: string;
+    /**
+     * Optional publication date.
+     */
+    readonly published_at?: string;
+}
+/**
+ * Web search response.
+ */
+export interface WebSearchResponse {
+    /**
+     * Search results array.
+     */
+    readonly results: WebSearchResultEntry[];
+    /**
+     * Number of results returned.
+     */
+    readonly count: number;
+}
+/**
+ * Web fetch request parameters.
+ */
+export interface WebFetchUrlRequest {
+    /**
+     * URL to fetch.
+     */
+    readonly url: string;
+    /**
+     * Optional extraction prompt.
+     */
+    readonly prompt?: string;
+    /**
+     * Maximum content length in characters.
+     */
+    readonly maxChars?: number;
+}
+/**
+ * Web fetch cursor pagination parameters.
+ */
+export interface WebFetchCursorRequest {
+    /**
+     * Cursor identifier returned by a previous fetch.
+     */
+    readonly cursor: string;
+    /**
+     * Offset in characters.
+     */
+    readonly offsetChars?: number;
+    /**
+     * Limit in characters.
+     */
+    readonly limitChars?: number;
+    /**
+     * Optional maximum content length in characters.
+     *
+     * @remarks
+     * When reading a cursor slice, EnriProxy may treat `maxChars` as a fallback
+     * limit if `limitChars` is not provided.
+     */
+    readonly maxChars?: number;
+}
+/**
+ * Web fetch request union.
+ */
+export type WebFetchRequest = WebFetchUrlRequest | WebFetchCursorRequest;
+/**
+ * Web fetch response.
+ */
+export interface WebFetchResponse {
+    /**
+     * Fetched content.
+     */
+    readonly content: string;
+    /**
+     * HTTP status code.
+     */
+    readonly status: number;
+    /**
+     * Content type from the response.
+     */
+    readonly content_type: string;
+    /**
+     * Whether content was truncated.
+     */
+    readonly truncated: boolean;
+    /**
+     * URL that was fetched (when available).
+     */
+    readonly url?: string;
+    /**
+     * Opaque cursor identifier for pagination (when content is truncated/reduced).
+     */
+    readonly cursor?: string;
+    /**
+     * Offset in characters (cursor reads).
+     */
+    readonly offset_chars?: number;
+    /**
+     * Limit in characters (cursor reads).
+     */
+    readonly limit_chars?: number;
+    /**
+     * Total captured characters available for this cursor.
+     */
+    readonly total_chars?: number;
+    /**
+     * Whether more content exists beyond this slice.
+     */
+    readonly has_more?: boolean;
+    /**
+     * Whether the response content was reduced (excerpt pack).
+     */
+    readonly reduced?: boolean;
+    /**
+     * Whether the upstream fetch was truncated (download/capture limits).
+     */
+    readonly fetched_truncated?: boolean;
+}
+/**
+ * Error thrown when EnriProxy returns a non-2xx HTTP response.
+ */
+export declare class EnriProxyHttpError extends Error {
+    /**
+     * HTTP status code returned by the server.
+     */
+    readonly status: number;
+    /**
+     * Response headers returned by the server.
+     */
+    readonly headers: Record<string, string | string[] | undefined>;
+    /**
+     * Response body returned by the server (best-effort UTF-8).
+     */
+    readonly body: string;
+    /**
+     * Creates a new {@link EnriProxyHttpError}.
+     *
+     * @param message - Error message
+     * @param status - HTTP status code
+     * @param headers - Response headers
+     * @param body - Response body
+     */
+    constructor(message: string, status: number, headers: Record<string, string | string[] | undefined>, body: string);
+}
+/**
+ * Minimal client for EnriProxy web tool endpoints.
+ */
+export declare class EnriProxyClient {
+    /**
+     * EnriProxy base URL.
+     */
+    private readonly baseUrl;
+    /**
+     * API key for Authorization header.
+     */
+    private readonly apiKey;
+    /**
+     * Default timeout for requests.
+     */
+    private readonly timeoutMs;
+    /**
+     * Creates a new {@link EnriProxyClient}.
+     *
+     * @param config - Client configuration
+     */
+    constructor(config: EnriProxyClientConfig);
+    /**
+     * Executes a web search via EnriProxy.
+     *
+     * @param params - Search parameters
+     * @returns Search response
+     */
+    webSearch(params: WebSearchRequest): Promise<WebSearchResponse>;
+    /**
+     * Executes a web fetch via EnriProxy.
+     *
+     * @param params - Fetch parameters
+     * @returns Fetch response
+     */
+    webFetch(params: WebFetchRequest): Promise<WebFetchResponse>;
+    /**
+     * Builds an absolute URL relative to the configured base URL.
+     *
+     * @param pathname - Pathname to append
+     * @returns URL instance
+     */
+    private buildUrl;
+    /**
+     * Sends a JSON request and returns the response.
+     *
+     * @param method - HTTP method
+     * @param url - Target URL
+     * @param jsonBody - JSON payload
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns HTTP result
+     */
+    private requestJson;
+    /**
+     * Sends an HTTP request with optional headers and body.
+     *
+     * @param method - HTTP method
+     * @param url - Target URL
+     * @param headers - Request headers
+     * @param body - Request body
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns HTTP result
+     */
+    private requestRaw;
+}
+//# sourceMappingURL=EnriProxyClient.d.ts.map

package/dist/client/EnriProxyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnriProxyClient.d.ts","sourceRoot":"","sources":["../../src/client/EnriProxyClient.ts"],"names":[],"mappings":"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"}

package/dist/client/EnriProxyClient.js

@@ -0,0 +1,221 @@
+/**
+ * ENRIPROXY CLIENT
+ *
+ * Minimal HTTP client for EnriProxy web tool endpoints:
+ * - POST /v1/tools/web_search
+ * - POST /v1/tools/web_fetch
+ *
+ * @module client/EnriProxyClient
+ */
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+import { URL } from "node:url";
+/**
+ * Error thrown when EnriProxy returns a non-2xx HTTP response.
+ */
+export class EnriProxyHttpError extends Error {
+    /**
+     * HTTP status code returned by the server.
+     */
+    status;
+    /**
+     * Response headers returned by the server.
+     */
+    headers;
+    /**
+     * Response body returned by the server (best-effort UTF-8).
+     */
+    body;
+    /**
+     * Creates a new {@link EnriProxyHttpError}.
+     *
+     * @param message - Error message
+     * @param status - HTTP status code
+     * @param headers - Response headers
+     * @param body - Response body
+     */
+    constructor(message, status, headers, body) {
+        super(message);
+        this.name = "EnriProxyHttpError";
+        this.status = status;
+        this.headers = headers;
+        this.body = body;
+    }
+}
+/**
+ * Minimal client for EnriProxy web tool endpoints.
+ */
+export class EnriProxyClient {
+    /**
+     * EnriProxy base URL.
+     */
+    baseUrl;
+    /**
+     * API key for Authorization header.
+     */
+    apiKey;
+    /**
+     * Default timeout for requests.
+     */
+    timeoutMs;
+    /**
+     * Creates a new {@link EnriProxyClient}.
+     *
+     * @param config - Client configuration
+     */
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+        this.timeoutMs = config.timeoutMs;
+    }
+    /**
+     * Executes a web search via EnriProxy.
+     *
+     * @param params - Search parameters
+     * @returns Search response
+     */
+    async webSearch(params) {
+        const url = this.buildUrl("/v1/tools/web_search");
+        const payload = {
+            query: params.query
+        };
+        if (typeof params.maxResults === "number") {
+            payload["max_results"] = params.maxResults;
+        }
+        if (typeof params.recency === "string" && params.recency.trim()) {
+            payload["recency"] = params.recency.trim();
+        }
+        if (Array.isArray(params.allowedDomains) && params.allowedDomains.length > 0) {
+            payload["allowed_domains"] = params.allowedDomains;
+        }
+        if (Array.isArray(params.blockedDomains) && params.blockedDomains.length > 0) {
+            payload["blocked_domains"] = params.blockedDomains;
+        }
+        if (typeof params.searchPrompt === "string" && params.searchPrompt.trim()) {
+            payload["search_prompt"] = params.searchPrompt.trim();
+        }
+        const result = await this.requestJson("POST", url, payload, this.timeoutMs);
+        if (result.status < 200 || result.status >= 300) {
+            throw new EnriProxyHttpError(`Web search failed (HTTP ${result.status}).`, result.status, result.headers, result.body);
+        }
+        return JSON.parse(result.body);
+    }
+    /**
+     * Executes a web fetch via EnriProxy.
+     *
+     * @param params - Fetch parameters
+     * @returns Fetch response
+     */
+    async webFetch(params) {
+        const url = this.buildUrl("/v1/tools/web_fetch");
+        const payload = {};
+        if ("cursor" in params) {
+            const cursor = params.cursor.trim();
+            if (!cursor) {
+                throw new Error("webFetch requires a non-empty cursor.");
+            }
+            payload["cursor"] = cursor;
+            if (typeof params.offsetChars === "number" && Number.isFinite(params.offsetChars)) {
+                payload["offset_chars"] = Math.max(0, Math.trunc(params.offsetChars));
+            }
+            if (typeof params.limitChars === "number" && Number.isFinite(params.limitChars)) {
+                payload["limit_chars"] = Math.max(1, Math.trunc(params.limitChars));
+            }
+            if (typeof params.maxChars === "number" && Number.isFinite(params.maxChars)) {
+                payload["max_chars"] = Math.max(1, Math.trunc(params.maxChars));
+            }
+        }
+        else {
+            payload["url"] = params.url;
+            if (typeof params.prompt === "string" && params.prompt.trim()) {
+                payload["prompt"] = params.prompt.trim();
+            }
+            if (typeof params.maxChars === "number") {
+                payload["max_chars"] = params.maxChars;
+            }
+        }
+        const result = await this.requestJson("POST", url, payload, this.timeoutMs);
+        if (result.status < 200 || result.status >= 300) {
+            throw new EnriProxyHttpError(`Web fetch failed (HTTP ${result.status}).`, result.status, result.headers, result.body);
+        }
+        return JSON.parse(result.body);
+    }
+    /**
+     * Builds an absolute URL relative to the configured base URL.
+     *
+     * @param pathname - Pathname to append
+     * @returns URL instance
+     */
+    buildUrl(pathname) {
+        return new URL(pathname, this.baseUrl);
+    }
+    /**
+     * Sends a JSON request and returns the response.
+     *
+     * @param method - HTTP method
+     * @param url - Target URL
+     * @param jsonBody - JSON payload
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns HTTP result
+     */
+    async requestJson(method, url, jsonBody, timeoutMs) {
+        const body = JSON.stringify(jsonBody);
+        const headers = {
+            "Content-Type": "application/json",
+            "Content-Length": String(Buffer.byteLength(body))
+        };
+        return this.requestRaw(method, url, headers, Buffer.from(body, "utf8"), timeoutMs);
+    }
+    /**
+     * Sends an HTTP request with optional headers and body.
+     *
+     * @param method - HTTP method
+     * @param url - Target URL
+     * @param headers - Request headers
+     * @param body - Request body
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns HTTP result
+     */
+    async requestRaw(method, url, headers, body, timeoutMs) {
+        const isHttps = url.protocol === "https:";
+        const reqFn = isHttps ? httpsRequest : httpRequest;
+        const requestHeaders = {
+            Authorization: `Bearer ${this.apiKey}`,
+            ...(headers ?? {})
+        };
+        return await new Promise((resolve, reject) => {
+            const req = reqFn(url, {
+                method,
+                headers: requestHeaders
+            }, (res) => {
+                const chunks = [];
+                let received = 0;
+                const maxResponseBytes = 20 * 1024 * 1024;
+                res.on("data", (chunk) => {
+                    received += chunk.length;
+                    if (received > maxResponseBytes) {
+                        req.destroy(new Error("Response exceeded maximum allowed size."));
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
+                res.on("end", () => {
+                    resolve({
+                        status: res.statusCode ?? 0,
+                        headers: res.headers,
+                        body: Buffer.concat(chunks).toString("utf8")
+                    });
+                });
+            });
+            req.on("error", (error) => reject(error));
+            req.setTimeout(timeoutMs, () => {
+                req.destroy(new Error(`Request timed out after ${timeoutMs}ms`));
+            });
+            if (body && body.length > 0) {
+                req.write(body);
+            }
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=EnriProxyClient.js.map

package/dist/client/EnriProxyClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnriProxyClient.js","sourceRoot":"","sources":["../../src/client/EnriProxyClient.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}