@perplexity-ai/mcp-server 0.2.2 → 0.13.0

package/src/tools/index.ts

@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, Endpoint, HandlerFunction } from './types';
+
+export { Metadata, Endpoint, HandlerFunction };
+
+import create_chat_completions from './chat/completions/create-chat-completions';
+import create_search from './search/create-search';
+
+export const endpoints: Endpoint[] = [];
+
+function addEndpoint(endpoint: Endpoint) {
+  endpoints.push(endpoint);
+}
+
+addEndpoint(create_chat_completions);
+addEndpoint(create_search);
+
+export type Filter = {
+  type: 'resource' | 'operation' | 'tag' | 'tool';
+  op: 'include' | 'exclude';
+  value: string;
+};
+
+export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
+  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
+  const unmatchedFilters = new Set(filters);
+
+  const filtered = endpoints.filter((endpoint: Endpoint) => {
+    let included = false || allExcludes;
+
+    for (const filter of filters) {
+      if (match(filter, endpoint)) {
+        unmatchedFilters.delete(filter);
+        included = filter.op === 'include';
+      }
+    }
+
+    return included;
+  });
+
+  // Check if any filters didn't match
+  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
+  if (unmatched.length > 0) {
+    throw new Error(
+      `The following filters did not match any endpoints: ${unmatched
+        .map((f) => `${f.type}=${f.value}`)
+        .join(', ')}`,
+    );
+  }
+
+  return filtered;
+}
+
+function match({ type, value }: Filter, endpoint: Endpoint): boolean {
+  switch (type) {
+    case 'resource': {
+      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
+      const regex = new RegExp(regexStr);
+      return regex.test(normalizeResource(endpoint.metadata.resource));
+    }
+    case 'operation':
+      return endpoint.metadata.operation === value;
+    case 'tag':
+      return endpoint.metadata.tags.includes(value);
+    case 'tool':
+      return endpoint.tool.name === value;
+  }
+}
+
+function normalizeResource(resource: string): string {
+  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
+}

package/src/tools/search/create-search.ts

@@ -0,0 +1,89 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@perplexity-ai/mcp-server/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Perplexity from '@perplexity-ai/perplexity_ai';
+
+export const metadata: Metadata = {
+  resource: 'search',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/search',
+  operationId: 'search_search_post',
+};
+
+export const tool: Tool = {
+  name: 'create_search',
+  description: 'Search the web and retrieve relevant web page contents.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        anyOf: [
+          {
+            type: 'string',
+          },
+          {
+            type: 'array',
+            items: {
+              type: 'string',
+            },
+          },
+        ],
+        title: 'Query',
+      },
+      display_server_time: {
+        type: 'boolean',
+        title: 'Display Server Time',
+      },
+      max_results: {
+        type: 'integer',
+        title: 'Max Results',
+      },
+      max_tokens: {
+        type: 'integer',
+        title: 'Max Tokens',
+      },
+      max_tokens_per_page: {
+        type: 'integer',
+        title: 'Max Tokens Per Page',
+      },
+      search_after_date_filter: {
+        type: 'string',
+        title: 'Search After Date Filter',
+      },
+      search_before_date_filter: {
+        type: 'string',
+        title: 'Search Before Date Filter',
+      },
+      search_domain_filter: {
+        type: 'array',
+        title: 'Search Domain Filter',
+        items: {
+          type: 'string',
+        },
+      },
+      search_mode: {
+        type: 'string',
+        title: 'Search Mode',
+        enum: ['web', 'academic', 'sec'],
+      },
+      search_recency_filter: {
+        type: 'string',
+        title: 'Search Recency Filter',
+        enum: ['hour', 'day', 'week', 'month', 'year'],
+      },
+    },
+    required: ['query'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Perplexity, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return asTextContentResult(await client.search.create(body));
+};
+
+export default { metadata, tool, handler };

package/src/tools/types.ts

@@ -0,0 +1,103 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Perplexity from '@perplexity-ai/perplexity_ai';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+type TextContentBlock = {
+  type: 'text';
+  text: string;
+};
+
+type ImageContentBlock = {
+  type: 'image';
+  data: string;
+  mimeType: string;
+};
+
+type AudioContentBlock = {
+  type: 'audio';
+  data: string;
+  mimeType: string;
+};
+
+type ResourceContentBlock = {
+  type: 'resource';
+  resource:
+    | {
+        uri: string;
+        mimeType: string;
+        text: string;
+      }
+    | {
+        uri: string;
+        mimeType: string;
+        blob: string;
+      };
+};
+
+export type ContentBlock = TextContentBlock | ImageContentBlock | AudioContentBlock | ResourceContentBlock;
+
+export type ToolCallResult = {
+  content: ContentBlock[];
+  isError?: boolean;
+};
+
+export type HandlerFunction = (
+  client: Perplexity,
+  args: Record<string, unknown> | undefined,
+) => Promise<ToolCallResult>;
+
+export function asTextContentResult(result: unknown): ToolCallResult {
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  };
+}
+
+export async function asBinaryContentResult(response: Response): Promise<ToolCallResult> {
+  const blob = await response.blob();
+  const mimeType = blob.type;
+  const data = Buffer.from(await blob.arrayBuffer()).toString('base64');
+  if (mimeType.startsWith('image/')) {
+    return {
+      content: [{ type: 'image', mimeType, data }],
+    };
+  } else if (mimeType.startsWith('audio/')) {
+    return {
+      content: [{ type: 'audio', mimeType, data }],
+    };
+  } else {
+    return {
+      content: [
+        {
+          type: 'resource',
+          resource: {
+            // We must give a URI, even though this isn't actually an MCP resource.
+            uri: 'resource://tool-response',
+            mimeType,
+            blob: data,
+          },
+        },
+      ],
+    };
+  }
+}
+
+export type Metadata = {
+  resource: string;
+  operation: 'read' | 'write';
+  tags: string[];
+  httpMethod?: string;
+  httpPath?: string;
+  operationId?: string;
+};
+
+export type Endpoint = {
+  metadata: Metadata;
+  tool: Tool;
+  handler: HandlerFunction;
+};

package/src/tools.ts

@@ -0,0 +1 @@
+export * from './tools/index';

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "es2015",
+    "lib": ["DOM"],
+    "moduleResolution": "node"
+  }
+}

package/stdio.d.mts

@@ -0,0 +1,3 @@
+import { McpOptions } from "./options.mjs";
+export declare const launchStdioServer: (options: McpOptions) => Promise<void>;
+//# sourceMappingURL=stdio.d.mts.map

package/stdio.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.mts","sourceRoot":"","sources":["src/stdio.ts"],"names":[],"mappings":"OAEO,EAAE,UAAU,EAAE;AAErB,eAAO,MAAM,iBAAiB,GAAU,SAAS,UAAU,kBAQ1D,CAAC"}

package/stdio.d.ts

@@ -0,0 +1,3 @@
+import { McpOptions } from "./options.js";
+export declare const launchStdioServer: (options: McpOptions) => Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["src/stdio.ts"],"names":[],"mappings":"OAEO,EAAE,UAAU,EAAE;AAErB,eAAO,MAAM,iBAAiB,GAAU,SAAS,UAAU,kBAQ1D,CAAC"}

package/stdio.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchStdioServer = void 0;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server.js");
+const launchStdioServer = async (options) => {
+    const server = (0, server_1.newMcpServer)();
+    (0, server_1.initMcpServer)({ server, mcpOptions: options });
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('MCP Server running on stdio');
+};
+exports.launchStdioServer = launchStdioServer;
+//# sourceMappingURL=stdio.js.map

package/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["src/stdio.ts"],"names":[],"mappings":";;;AAAA,wEAAiF;AACjF,wCAAuD;AAGhD,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAmB,EAAE,EAAE;IAC7D,MAAM,MAAM,GAAG,IAAA,qBAAY,GAAE,CAAC;IAE9B,IAAA,sBAAa,EAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC/C,CAAC,CAAC;AARW,QAAA,iBAAiB,qBAQ5B"}

package/stdio.mjs

@@ -0,0 +1,10 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { initMcpServer, newMcpServer } from "./server.mjs";
+export const launchStdioServer = async (options) => {
+    const server = newMcpServer();
+    initMcpServer({ server, mcpOptions: options });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MCP Server running on stdio');
+};
+//# sourceMappingURL=stdio.mjs.map

package/stdio.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.mjs","sourceRoot":"","sources":["src/stdio.ts"],"names":[],"mappings":"OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C;OACzE,EAAE,aAAa,EAAE,YAAY,EAAE;AAGtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAmB,EAAE,EAAE;IAC7D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC/C,CAAC,CAAC"}

package/tools/chat/completions/create-chat-completions.d.mts

@@ -0,0 +1,45 @@
+import { Metadata } from '@perplexity-ai/mcp-server/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Perplexity from '@perplexity-ai/perplexity_ai';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Perplexity, args: Record<string, unknown> | undefined) => Promise<import("@perplexity-ai/mcp-server/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Perplexity, args: Record<string, unknown> | undefined) => Promise<import("@perplexity-ai/mcp-server/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=create-chat-completions.d.mts.map

package/tools/chat/completions/create-chat-completions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-chat-completions.d.mts","sourceRoot":"","sources":["../../../src/tools/chat/completions/create-chat-completions.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,uCAAuC;OAE9E,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,UAAU,MAAM,8BAA8B;AAErD,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAwzClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,4EAG1F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,UAAU,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK3F,wBAA2C"}

package/tools/chat/completions/create-chat-completions.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from '@perplexity-ai/mcp-server/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Perplexity from '@perplexity-ai/perplexity_ai';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Perplexity, args: Record<string, unknown> | undefined) => Promise<import("@perplexity-ai/mcp-server/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Perplexity, args: Record<string, unknown> | undefined) => Promise<import("@perplexity-ai/mcp-server/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=create-chat-completions.d.ts.map

package/tools/chat/completions/create-chat-completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-chat-completions.d.ts","sourceRoot":"","sources":["../../../src/tools/chat/completions/create-chat-completions.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,uCAAuC;OAE9E,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,UAAU,MAAM,8BAA8B;AAErD,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAwzClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,4EAG1F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,UAAU,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK3F,wBAA2C"}