tinyfish-mcp-lite 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { ConfigError, parseConfig } from "./config.js";
+import { createProxyCore } from "./core/proxy-core.js";
+// FORK(lite): free-tool allowlist — see src/core/tool-filter.ts and FORK.md.
+import { parseToolPolicy, withToolFilter } from "./core/tool-filter.js";
+import { createMcpAdapter } from "./http/adapter.js";
+import { createAppHandler, startHttpServer } from "./http/index.js";
+import { log } from "./log.js";
+import { shutdownHooks } from "./shutdown.js";
+import { VERSION } from "./version.js";
+function isErrnoException(err) {
+    return err instanceof Error && "code" in err;
+}
+async function main() {
+    let config;
+    let toolPolicy; // FORK(lite)
+    try {
+        config = parseConfig(process.env);
+        // FORK(lite): TINYFISH_TOOLS allowlist (default: the free search +
+        // fetch_content; "*" restores unfiltered upstream passthrough).
+        toolPolicy = parseToolPolicy(process.env.TINYFISH_TOOLS);
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    // The real MCP handler: origin/routing shell → adapter → proxy core.
+    // createProxyCore registers session teardown into shutdownHooks itself.
+    // FORK(lite): the decorator hides non-allowed tools from tools/list and
+    // answers tools/call for them locally — paid tools are never advertised
+    // and never invoked upstream.
+    const core = withToolFilter(createProxyCore({ upstreamUrl: config.upstreamUrl, apiKey: config.apiKey }), toolPolicy);
+    const handler = createAppHandler(createMcpAdapter(core));
+    let server;
+    try {
+        server = await startHttpServer(config.port, handler);
+    }
+    catch (err) {
+        if (isErrnoException(err) && err.code === "EADDRINUSE") {
+            log.error(`Port ${config.port} is already in use — stop the other process or set PORT to a free port`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    // The one startup line. Never include config.apiKey here or in any other log call.
+    log.info(`listening on http://127.0.0.1:${config.port} — upstream ${config.upstreamUrl} — v${VERSION}`);
+    // FORK(lite): state the active tool policy so a "missing tool" is never a
+    // mystery. Tool names only — never the API key.
+    if (toolPolicy.mode === "allow") {
+        log.info(`tool filter: exposing [${[...toolPolicy.allowed].join(", ")}] — set TINYFISH_TOOLS=* to expose every upstream tool`);
+    }
+    else {
+        log.info("tool filter: off (TINYFISH_TOOLS=*) — exposing every upstream tool");
+    }
+    let shuttingDown = false;
+    const shutdown = async () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        server.close();
+        for (const hook of shutdownHooks) {
+            try {
+                await hook();
+            }
+            catch (err) {
+                log.error(`shutdown hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+}
+main().catch((err) => {
+    log.error(`startup failed: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});

package/dist/log.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Minimal leveled logger. Writes to stderr only — stdout stays clean for a
+ * future stdio transport. Callers must never pass the API key into a message.
+ */
+export type LogLevel = "info" | "warn" | "error";
+export declare const log: {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};

package/dist/log.js

@@ -0,0 +1,18 @@
+/**
+ * Minimal leveled logger. Writes to stderr only — stdout stays clean for a
+ * future stdio transport. Callers must never pass the API key into a message.
+ */
+function write(level, message) {
+    process.stderr.write(`tinyfish-mcp [${level}] ${message}\n`);
+}
+export const log = {
+    info(message) {
+        write("info", message);
+    },
+    warn(message) {
+        write("warn", message);
+    },
+    error(message) {
+        write("error", message);
+    },
+};

package/dist/shutdown.d.ts

@@ -0,0 +1,2 @@
+/** Cleanup hooks (e.g. session teardown) run on SIGINT/SIGTERM before exit. */
+export declare const shutdownHooks: Array<() => void | Promise<void>>;

package/dist/shutdown.js

@@ -0,0 +1,2 @@
+/** Cleanup hooks (e.g. session teardown) run on SIGINT/SIGTERM before exit. */
+export const shutdownHooks = [];

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** Package version, read once at startup. Feeds X-TF-Client-Version upstream. */
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,6 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+// Resolves to the package root's package.json from both src/ (dev) and dist/ (published).
+const pkg = require("../package.json");
+/** Package version, read once at startup. Feeds X-TF-Client-Version upstream. */
+export const VERSION = pkg.version;

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "tinyfish-mcp-lite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Fork of @tiny-fish/mcp exposing only the free TinyFish tools (search, fetch_content) \u2014 local reverse proxy to agent.tinyfish.ai/mcp",
+  "mcpName": "io.github.ByronFinn/tinyfish-mcp-lite",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ByronFinn/tinyfish-mcp-lite.git"
+  },
+  "homepage": "https://github.com/ByronFinn/tinyfish-mcp-lite#readme",
+  "bugs": {
+    "url": "https://github.com/ByronFinn/tinyfish-mcp-lite/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tinyfish",
+    "web-automation",
+    "browser-automation",
+    "proxy"
+  ],
+  "author": "ByronFinn (fork of TinyFish's tinyfish-mcp-server, MIT)",
+  "type": "module",
+  "license": "MIT",
+  "allowScripts": {
+    "tinyfish-mcp-lite": true,
+    "esbuild": true,
+    "fsevents": true
+  },
+  "bin": {
+    "tinyfish-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:integration": "vitest --run --config vitest.integration.config.ts",
+    "lint": "eslint src tests",
+    "format": "prettier --write src tests",
+    "type-check": "tsc --noEmit --project tsconfig.all.json",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.23.1",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "overrides": {
+    "@vitest/mocker": "^4.1.11",
+    "fast-uri": "^3.1.8",
+    "nanoid": "^3.3.19",
+    "qs": "^6.16.0"
+  }
+}