@kkaminsk/modelcontextprotocol 0.2.2

package/dist/utils.js

@@ -0,0 +1,124 @@
+/**
+ * Shared utility functions and types for the Perplexity MCP Server.
+ * This module contains testable code without side effects.
+ */
+// Configuration constants
+export const DEFAULT_TIMEOUT_MS = 300000;
+export const MAX_DOMAIN_FILTERS = 20;
+export const MAX_BATCH_QUERIES = 5;
+export const DEFAULT_MODEL = "sonar-pro";
+/**
+ * Builds common options from tool arguments with validation.
+ * Extracts and validates shared parameters used across multiple tools.
+ *
+ * @param {Record<string, unknown>} args - The tool arguments.
+ * @returns {CommonOptions} The validated options object.
+ */
+export function buildCommonOptions(args) {
+    const options = {};
+    // Extract and validate search_domain_filter
+    if (Array.isArray(args.search_domain_filter)) {
+        const filtered = args.search_domain_filter.filter((d) => typeof d === "string");
+        if (filtered.length > 0) {
+            options.search_domain_filter = filtered;
+        }
+    }
+    // Extract numeric parameters with type checking
+    if (typeof args.temperature === "number") {
+        options.temperature = args.temperature;
+    }
+    if (typeof args.max_tokens === "number") {
+        options.max_tokens = args.max_tokens;
+    }
+    if (typeof args.top_p === "number") {
+        options.top_p = args.top_p;
+    }
+    if (typeof args.top_k === "number") {
+        options.top_k = args.top_k;
+    }
+    // Extract search_mode with validation
+    if (typeof args.search_mode === "string" && ["web", "academic", "sec"].includes(args.search_mode)) {
+        options.search_mode = args.search_mode;
+    }
+    // Extract search_recency_filter with validation
+    if (typeof args.search_recency_filter === "string" && ["day", "week", "month", "year"].includes(args.search_recency_filter)) {
+        options.search_recency_filter = args.search_recency_filter;
+    }
+    // Extract date filters
+    if (typeof args.search_after_date === "string") {
+        options.search_after_date = args.search_after_date;
+    }
+    if (typeof args.search_before_date === "string") {
+        options.search_before_date = args.search_before_date;
+    }
+    if (typeof args.last_updated_after === "string") {
+        options.last_updated_after = args.last_updated_after;
+    }
+    if (typeof args.last_updated_before === "string") {
+        options.last_updated_before = args.last_updated_before;
+    }
+    // Extract boolean options
+    if (args.return_images === true) {
+        options.return_images = true;
+    }
+    if (args.return_related_questions === true) {
+        options.return_related_questions = true;
+    }
+    return options;
+}
+/**
+ * Formats search results into a readable string.
+ *
+ * @param {PerplexitySearchResponse} data - The search response data.
+ * @returns {string} Formatted search results.
+ */
+export function formatSearchResults(data) {
+    if (!data.results || !Array.isArray(data.results)) {
+        return "No search results found.";
+    }
+    let formattedResults = `Found ${data.results.length} search results:\n\n`;
+    data.results.forEach((result, index) => {
+        formattedResults += `${index + 1}. **${result.title}**\n`;
+        formattedResults += `   URL: ${result.url}\n`;
+        if (result.snippet) {
+            formattedResults += `   ${result.snippet}\n`;
+        }
+        if (result.date) {
+            formattedResults += `   Date: ${result.date}\n`;
+        }
+        formattedResults += `\n`;
+    });
+    return formattedResults;
+}
+/**
+ * Formats multi-query search results into a readable string.
+ *
+ * @param {Array<{query: string, data: PerplexitySearchResponse | null, error: string | null}>} results - The search results per query.
+ * @returns {string} Formatted multi-query search results.
+ */
+export function formatMultiQueryResults(results) {
+    const sections = results.map((result, queryIndex) => {
+        var _a;
+        const header = `## Query ${queryIndex + 1}: "${result.query}"\n`;
+        if (result.error) {
+            return header + `\n**Error:** ${result.error}\n`;
+        }
+        if (!((_a = result.data) === null || _a === void 0 ? void 0 : _a.results) || !Array.isArray(result.data.results)) {
+            return header + `\nNo search results found.\n`;
+        }
+        let formattedResults = `\nFound ${result.data.results.length} results:\n\n`;
+        result.data.results.forEach((r, index) => {
+            formattedResults += `${index + 1}. **${r.title}**\n`;
+            formattedResults += `   URL: ${r.url}\n`;
+            if (r.snippet) {
+                formattedResults += `   ${r.snippet}\n`;
+            }
+            if (r.date) {
+                formattedResults += `   Date: ${r.date}\n`;
+            }
+            formattedResults += `\n`;
+        });
+        return header + formattedResults;
+    });
+    return sections.join("\n---\n\n");
+}

package/dist/vitest.config.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["**/*.test.ts"],
+        exclude: ["node_modules", "dist"],
+        coverage: {
+            provider: "v8",
+            reporter: ["text", "html"],
+            include: ["index.ts", "utils.ts"],
+            exclude: ["**/*.test.ts", "vitest.config.ts"],
+        },
+    },
+});

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@kkaminsk/modelcontextprotocol",
+  "version": "0.2.2",
+  "description": "MCP server for the Perplexity API Platform (fork of @perplexity-ai/mcp-server)",
+  "keywords": [
+    "ai",
+    "perplexity",
+    "mcp",
+    "modelcontextprotocol"
+  ],
+  "homepage": "https://github.com/kkaminsk/modelcontextprotocol#readme",
+  "bugs": {
+    "url": "https://github.com/kkaminsk/modelcontextprotocol/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkaminsk/modelcontextprotocol.git"
+  },
+  "license": "MIT",
+  "author": "Perplexity <>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "perplexity-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "build:installer": "powershell -ExecutionPolicy Bypass -File installer/Build-Installer.ps1",
+    "build:installer:clean": "powershell -ExecutionPolicy Bypass -File installer/Build-Installer.ps1 -Clean",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "watch": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.7",
+    "@vitest/coverage-v8": "^3.2.4",
+    "axios": "^1.13.2",
+    "dotenv": "^16.3.1",
+    "openspec": "^0.0.0",
+    "shx": "^0.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}