@rankcli/mcp-server 0.0.7 → 0.0.9

package/dist/server.d.ts

@@ -0,0 +1,56 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+
+interface FetchGuardOptions {
+    /** Refuse loopback, private, link-local, CGNAT and metadata addresses. */
+    blockPrivateNetworks?: boolean;
+}
+/** Loopback, private, link-local, CGNAT, multicast/reserved - anything not on the public internet. */
+declare function isPrivateAddress(ip: string): boolean;
+
+/**
+ * Shared, stateless SEO/GEO analysis tools - the part of the RankCLI MCP
+ * server that's safe to run anywhere, local stdio process or a shared
+ * remote HTTP endpoint, since none of it touches per-user local state.
+ * rankcli_connect/rankcli_disconnect (which read/write a local Conf file)
+ * stay in index.ts, exclusive to the local stdio server - a shared remote
+ * instance can't safely do per-user "connect this session to your account"
+ * via local file storage.
+ */
+
+/** Options for the analysis tools. Everything defaults off, for local stdio use. */
+type AnalysisServerOptions = FetchGuardOptions;
+declare function fetchHtml(url: string, options?: AnalysisServerOptions): Promise<string>;
+interface RobotsTxtResult {
+    /** robots.txt body when the site served one (2xx). */
+    content?: string;
+    /** One line for the report: what was found, or why crawler access is unknown. */
+    note: string;
+    /** robots.txt couldn't be read (5xx, 429, network) - access is not known. */
+    unknown?: boolean;
+}
+/**
+ * The site's own robots.txt. seo_geo_check / seo_analyze used to skip this
+ * unless the caller pasted robots.txt in, and then reported every AI
+ * crawler as "allowed" - even on sites that block them all.
+ */
+declare function fetchRobotsTxt(pageUrl: string, options?: AnalysisServerOptions): Promise<RobotsTxtResult>;
+declare const ANALYSIS_TOOLS: Tool[];
+/**
+ * Handles a single analysis tool call. Returns undefined if `name` isn't
+ * one of ANALYSIS_TOOLS, so callers (index.ts's stdio server) can fall
+ * through to their own additional tools.
+ */
+declare function handleAnalysisTool(name: string, args: Record<string, unknown> | undefined, options?: AnalysisServerOptions): Promise<CallToolResult | undefined>;
+/**
+ * A fresh Server exposing only the stateless analysis tools - used by the
+ * remote HTTP endpoint, one instance per request (see packages/audit-worker),
+ * matching the MCP SDK's own stateless-server example.
+ *
+ * A shared deployment should pass { blockPrivateNetworks: true } so callers
+ * can't point the fetching tools at internal addresses. Off by default: the
+ * local stdio server auditing http://localhost:3000 is a feature.
+ */
+declare function createAnalysisServer(options?: AnalysisServerOptions): Server;
+
+export { ANALYSIS_TOOLS, type AnalysisServerOptions, type FetchGuardOptions, type RobotsTxtResult, createAnalysisServer, fetchHtml, fetchRobotsTxt, handleAnalysisTool, isPrivateAddress };

package/dist/server.js

@@ -0,0 +1,16 @@
+import {
+  ANALYSIS_TOOLS,
+  createAnalysisServer,
+  fetchHtml,
+  fetchRobotsTxt,
+  handleAnalysisTool,
+  isPrivateAddress
+} from "./chunk-FJ2K7KRV.js";
+export {
+  ANALYSIS_TOOLS,
+  createAnalysisServer,
+  fetchHtml,
+  fetchRobotsTxt,
+  handleAnalysisTool,
+  isPrivateAddress
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/mcp-server",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "mcpName": "io.github.integrallis/rankcli-mcp-server",
   "description": "Free, local SEO + GEO (AI-search-citation) analysis for AI assistants - audits GEO/AI-crawler access, Core Web Vitals, structured data, security headers, mobile, and images with no signup or API key.",
   "type": "module",
@@ -9,11 +9,21 @@
   "bin": {
     "rankcli-mcp": "./dist/index.js"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --watch",
+    "build": "tsup src/index.ts src/server.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/server.ts --format esm --watch",
     "typecheck": "tsc --noEmit",
-    "test": "echo 'No tests yet'",
+    "test": "vitest run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -41,12 +51,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@rankcli/agent-runtime": "^0.0.19",
+    "@rankcli/agent-runtime": "^0.0.21",
     "conf": "^12.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
   },
   "files": [
     "dist"