@mcp-z/client 1.0.0

package/dist/esm/response-wrappers.js

@@ -0,0 +1,201 @@
+import { Buffer } from 'node:buffer';
+export class ToolResponseError extends Error {
+    constructor(message, response){
+        super(message);
+        this.name = 'ToolResponseError';
+        this.response = response;
+    }
+}
+export class ToolResponseWrapper {
+    raw() {
+        return this.payload;
+    }
+    json(validator) {
+        const value = this.resolveJsonPayload();
+        if (validator) {
+            validator(value);
+        }
+        return value;
+    }
+    text() {
+        var _this_payload_content;
+        if (isCompatibilityResult(this.payload)) {
+            if (typeof this.payload.toolResult === 'string') {
+                return this.payload.toolResult;
+            }
+            throw new ToolResponseError('Compatibility tool result is not text', this.payload);
+        }
+        this.throwIfError();
+        const textBlock = findFirstTextBlock((_this_payload_content = this.payload.content) !== null && _this_payload_content !== void 0 ? _this_payload_content : []);
+        if (!textBlock) {
+            throw new ToolResponseError('Tool response did not include text content', this.payload);
+        }
+        return textBlock.text;
+    }
+    resolveJsonPayload() {
+        var _this_payload_content;
+        if (isCompatibilityResult(this.payload)) {
+            return this.payload.toolResult;
+        }
+        this.throwIfError();
+        if (hasStructuredContent(this.payload)) {
+            return this.payload.structuredContent;
+        }
+        const textBlock = findFirstTextBlock((_this_payload_content = this.payload.content) !== null && _this_payload_content !== void 0 ? _this_payload_content : []);
+        if (!textBlock) {
+            throw new ToolResponseError('Tool response did not include structuredContent or text content', this.payload);
+        }
+        try {
+            return JSON.parse(textBlock.text);
+        } catch (error) {
+            const reason = formatErrorReason(error);
+            throw new ToolResponseError(`Failed to parse tool text content as JSON: ${reason}`, this.payload);
+        }
+    }
+    throwIfError() {
+        if ('isError' in this.payload && this.payload.isError) {
+            var _this_payload_error_message;
+            let detail = typeof this.payload.error === 'object' && this.payload.error && 'message' in this.payload.error ? String((_this_payload_error_message = this.payload.error.message) !== null && _this_payload_error_message !== void 0 ? _this_payload_error_message : '') : '';
+            if (!detail) {
+                var _this_payload_content;
+                const textBlock = findFirstTextBlock((_this_payload_content = this.payload.content) !== null && _this_payload_content !== void 0 ? _this_payload_content : []);
+                if (textBlock === null || textBlock === void 0 ? void 0 : textBlock.text) {
+                    detail = textBlock.text;
+                }
+            }
+            const message = detail ? `Tool invocation returned an error result: ${detail}` : 'Tool invocation returned an error result';
+            throw new ToolResponseError(message, this.payload);
+        }
+    }
+    constructor(payload){
+        this.payload = payload;
+    }
+}
+export class PromptResponseError extends Error {
+    constructor(message, response){
+        super(message);
+        this.name = 'PromptResponseError';
+        this.response = response;
+    }
+}
+export class PromptResponseWrapper {
+    raw() {
+        return this.payload;
+    }
+    text() {
+        const segments = collectPromptText(this.payload.messages);
+        if (!segments.length) {
+            throw new PromptResponseError('Prompt response did not include text content', this.payload);
+        }
+        return segments.join('\n\n');
+    }
+    json(validator) {
+        const textValue = this.text();
+        try {
+            const parsed = JSON.parse(textValue);
+            if (validator) {
+                validator(parsed);
+            }
+            return parsed;
+        } catch (error) {
+            const reason = formatErrorReason(error);
+            throw new PromptResponseError(`Failed to parse prompt text as JSON: ${reason}`, this.payload);
+        }
+    }
+    constructor(payload){
+        this.payload = payload;
+    }
+}
+export class ResourceResponseError extends Error {
+    constructor(message, response){
+        super(message);
+        this.name = 'ResourceResponseError';
+        this.response = response;
+    }
+}
+export class ResourceResponseWrapper {
+    raw() {
+        return this.payload;
+    }
+    text() {
+        const entry = this.firstEntry();
+        if ('text' in entry && typeof entry.text === 'string') {
+            return entry.text;
+        }
+        if ('blob' in entry && typeof entry.blob === 'string') {
+            try {
+                return Buffer.from(entry.blob, 'base64').toString('utf8');
+            } catch (error) {
+                const reason = formatErrorReason(error);
+                throw new ResourceResponseError(`Failed to decode resource blob as UTF-8 text: ${reason}`, this.payload);
+            }
+        }
+        throw new ResourceResponseError('Resource content does not include text or blob data', this.payload);
+    }
+    json(validator) {
+        const textValue = this.text();
+        try {
+            const parsed = JSON.parse(textValue);
+            if (validator) {
+                validator(parsed);
+            }
+            return parsed;
+        } catch (error) {
+            const reason = formatErrorReason(error);
+            throw new ResourceResponseError(`Failed to parse resource text as JSON: ${reason}`, this.payload);
+        }
+    }
+    firstEntry() {
+        var _this_payload_contents;
+        const [entry] = (_this_payload_contents = this.payload.contents) !== null && _this_payload_contents !== void 0 ? _this_payload_contents : [];
+        if (!entry) {
+            throw new ResourceResponseError('Resource response did not include any contents', this.payload);
+        }
+        return entry;
+    }
+    constructor(payload){
+        this.payload = payload;
+    }
+}
+function hasStructuredContent(response) {
+    return Boolean(response.structuredContent);
+}
+function isCompatibilityResult(response) {
+    return hasOwn(response, 'toolResult');
+}
+function findFirstTextBlock(blocks) {
+    if (!Array.isArray(blocks)) {
+        return undefined;
+    }
+    return blocks.find(isTextContent);
+}
+function collectPromptText(messages) {
+    const segments = [];
+    for (const message of messages){
+        const textBlock = isTextContent(message.content) ? message.content : undefined;
+        if (textBlock) {
+            segments.push(textBlock.text);
+        }
+    }
+    return segments;
+}
+function isTextContent(block) {
+    return Boolean(block) && typeof block === 'object' && block.type === 'text';
+}
+const protoHasOwn = Object.prototype.hasOwnProperty;
+function hasOwn(target, key) {
+    return protoHasOwn.call(target, key);
+}
+function formatErrorReason(error) {
+    if (error instanceof Error && typeof error.message === 'string') {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    try {
+        return JSON.stringify(error);
+    } catch  {
+        return String(error);
+    }
+}

package/dist/esm/response-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/response-wrappers.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport type { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { ContentBlock, PromptMessage, TextContent } from '@modelcontextprotocol/sdk/types.js';\n\nexport type NativeCallToolResponse = Awaited<ReturnType<Client['callTool']>>;\nexport type NativeGetPromptResponse = Awaited<ReturnType<Client['getPrompt']>>;\nexport type NativeReadResourceResponse = Awaited<ReturnType<Client['readResource']>>;\n\nexport type JsonValidator<T> = (value: unknown) => asserts value is T;\n\nexport class ToolResponseError extends Error {\n  readonly response: NativeCallToolResponse;\n\n  constructor(message: string, response: NativeCallToolResponse) {\n    super(message);\n    this.name = 'ToolResponseError';\n    this.response = response;\n  }\n}\n\nexport class ToolResponseWrapper {\n  private readonly payload: NativeCallToolResponse;\n\n  constructor(payload: NativeCallToolResponse) {\n    this.payload = payload;\n  }\n\n  raw(): NativeCallToolResponse {\n    return this.payload;\n  }\n\n  json<T = unknown>(validator?: JsonValidator<T>): T {\n    const value = this.resolveJsonPayload();\n    if (validator) {\n      validator(value);\n    }\n    return value as T;\n  }\n\n  text(): string {\n    if (isCompatibilityResult(this.payload)) {\n      if (typeof this.payload.toolResult === 'string') {\n        return this.payload.toolResult;\n      }\n      throw new ToolResponseError('Compatibility tool result is not text', this.payload);\n    }\n\n    this.throwIfError();\n\n    const textBlock = findFirstTextBlock(this.payload.content ?? []);\n    if (!textBlock) {\n      throw new ToolResponseError('Tool response did not include text content', this.payload);\n    }\n\n    return textBlock.text;\n  }\n\n  private resolveJsonPayload(): unknown {\n    if (isCompatibilityResult(this.payload)) {\n      return this.payload.toolResult;\n    }\n\n    this.throwIfError();\n\n    if (hasStructuredContent(this.payload)) {\n      return this.payload.structuredContent;\n    }\n\n    const textBlock = findFirstTextBlock(this.payload.content ?? []);\n    if (!textBlock) {\n      throw new ToolResponseError('Tool response did not include structuredContent or text content', this.payload);\n    }\n\n    try {\n      return JSON.parse(textBlock.text) as unknown;\n    } catch (error) {\n      const reason = formatErrorReason(error);\n      throw new ToolResponseError(`Failed to parse tool text content as JSON: ${reason}`, this.payload);\n    }\n  }\n\n  private throwIfError(): void {\n    if ('isError' in this.payload && this.payload.isError) {\n      let detail = typeof this.payload.error === 'object' && this.payload.error && 'message' in this.payload.error ? String((this.payload.error as { message?: unknown }).message ?? '') : '';\n      if (!detail) {\n        const textBlock = findFirstTextBlock((this.payload.content ?? []) as ContentBlock[]);\n        if (textBlock?.text) {\n          detail = textBlock.text;\n        }\n      }\n      const message = detail ? `Tool invocation returned an error result: ${detail}` : 'Tool invocation returned an error result';\n      throw new ToolResponseError(message, this.payload);\n    }\n  }\n}\n\nexport class PromptResponseError extends Error {\n  readonly response: NativeGetPromptResponse;\n\n  constructor(message: string, response: NativeGetPromptResponse) {\n    super(message);\n    this.name = 'PromptResponseError';\n    this.response = response;\n  }\n}\n\nexport class PromptResponseWrapper {\n  private readonly payload: NativeGetPromptResponse;\n\n  constructor(payload: NativeGetPromptResponse) {\n    this.payload = payload;\n  }\n\n  raw(): NativeGetPromptResponse {\n    return this.payload;\n  }\n\n  text(): string {\n    const segments = collectPromptText(this.payload.messages);\n    if (!segments.length) {\n      throw new PromptResponseError('Prompt response did not include text content', this.payload);\n    }\n    return segments.join('\\n\\n');\n  }\n\n  json<T = unknown>(validator?: JsonValidator<T>): T {\n    const textValue = this.text();\n    try {\n      const parsed = JSON.parse(textValue) as unknown;\n      if (validator) {\n        validator(parsed);\n      }\n      return parsed as T;\n    } catch (error) {\n      const reason = formatErrorReason(error);\n      throw new PromptResponseError(`Failed to parse prompt text as JSON: ${reason}`, this.payload);\n    }\n  }\n}\n\nexport class ResourceResponseError extends Error {\n  readonly response: NativeReadResourceResponse;\n\n  constructor(message: string, response: NativeReadResourceResponse) {\n    super(message);\n    this.name = 'ResourceResponseError';\n    this.response = response;\n  }\n}\n\nexport class ResourceResponseWrapper {\n  private readonly payload: NativeReadResourceResponse;\n\n  constructor(payload: NativeReadResourceResponse) {\n    this.payload = payload;\n  }\n\n  raw(): NativeReadResourceResponse {\n    return this.payload;\n  }\n\n  text(): string {\n    const entry = this.firstEntry();\n    if ('text' in entry && typeof entry.text === 'string') {\n      return entry.text;\n    }\n    if ('blob' in entry && typeof entry.blob === 'string') {\n      try {\n        return Buffer.from(entry.blob, 'base64').toString('utf8');\n      } catch (error) {\n        const reason = formatErrorReason(error);\n        throw new ResourceResponseError(`Failed to decode resource blob as UTF-8 text: ${reason}`, this.payload);\n      }\n    }\n    throw new ResourceResponseError('Resource content does not include text or blob data', this.payload);\n  }\n\n  json<T = unknown>(validator?: JsonValidator<T>): T {\n    const textValue = this.text();\n    try {\n      const parsed = JSON.parse(textValue) as unknown;\n      if (validator) {\n        validator(parsed);\n      }\n      return parsed as T;\n    } catch (error) {\n      const reason = formatErrorReason(error);\n      throw new ResourceResponseError(`Failed to parse resource text as JSON: ${reason}`, this.payload);\n    }\n  }\n\n  private firstEntry(): NativeReadResourceResponse['contents'][number] {\n    const [entry] = this.payload.contents ?? [];\n    if (!entry) {\n      throw new ResourceResponseError('Resource response did not include any contents', this.payload);\n    }\n    return entry;\n  }\n}\n\nfunction hasStructuredContent(response: NativeCallToolResponse): response is NativeCallToolResponse & { structuredContent: Record<string, unknown> } {\n  return Boolean((response as { structuredContent?: unknown }).structuredContent);\n}\n\nfunction isCompatibilityResult(response: NativeCallToolResponse): response is NativeCallToolResponse & { toolResult: unknown } {\n  return hasOwn(response, 'toolResult');\n}\n\nfunction findFirstTextBlock(blocks: ContentBlock[] | undefined): TextContent | undefined {\n  if (!Array.isArray(blocks)) {\n    return undefined;\n  }\n  return blocks.find(isTextContent);\n}\n\nfunction collectPromptText(messages: PromptMessage[]): string[] {\n  const segments: string[] = [];\n  for (const message of messages) {\n    const textBlock = isTextContent(message.content) ? message.content : undefined;\n    if (textBlock) {\n      segments.push(textBlock.text);\n    }\n  }\n  return segments;\n}\n\nfunction isTextContent(block: unknown): block is TextContent {\n  return Boolean(block) && typeof block === 'object' && (block as { type?: string }).type === 'text';\n}\n\nconst protoHasOwn = Object.prototype.hasOwnProperty;\n\nfunction hasOwn(target: object, key: PropertyKey): boolean {\n  return protoHasOwn.call(target, key);\n}\n\nfunction formatErrorReason(error: unknown): string {\n  if (error instanceof Error && typeof error.message === 'string') {\n    return error.message;\n  }\n  if (typeof error === 'string') {\n    return error;\n  }\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n}\n"],"names":["Buffer","ToolResponseError","Error","message","response","name","ToolResponseWrapper","raw","payload","json","validator","value","resolveJsonPayload","text","isCompatibilityResult","toolResult","throwIfError","textBlock","findFirstTextBlock","content","hasStructuredContent","structuredContent","JSON","parse","error","reason","formatErrorReason","isError","detail","String","PromptResponseError","PromptResponseWrapper","segments","collectPromptText","messages","length","join","textValue","parsed","ResourceResponseError","ResourceResponseWrapper","entry","firstEntry","blob","from","toString","contents","Boolean","hasOwn","blocks","Array","isArray","undefined","find","isTextContent","push","block","type","protoHasOwn","Object","prototype","hasOwnProperty","target","key","call","stringify"],"mappings":"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"}

package/dist/esm/search/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Search module for MCP capability discovery
+ */
+export type { CapabilityClient } from './search.js';
+export { buildCapabilityIndex, search, searchCapabilities } from './search.js';
+export type { CapabilityIndex, CapabilityType, IndexedCapability, IndexedPrompt, IndexedResource, IndexedTool, SearchField, SearchOptions, SearchResponse, SearchResult, } from './types.js';

package/dist/esm/search/index.js

@@ -0,0 +1,3 @@
+/**
+ * Search module for MCP capability discovery
+ */ export { buildCapabilityIndex, search, searchCapabilities } from './search.js';

package/dist/esm/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/search/index.ts"],"sourcesContent":["/**\n * Search module for MCP capability discovery\n */\n\nexport type { CapabilityClient } from './search.ts';\nexport { buildCapabilityIndex, search, searchCapabilities } from './search.ts';\nexport type {\n  CapabilityIndex,\n  CapabilityType,\n  IndexedCapability,\n  IndexedPrompt,\n  IndexedResource,\n  IndexedTool,\n  SearchField,\n  SearchOptions,\n  SearchResponse,\n  SearchResult,\n} from './types.ts';\n"],"names":["buildCapabilityIndex","search","searchCapabilities"],"mappings":"AAAA;;CAEC,GAGD,SAASA,oBAAoB,EAAEC,MAAM,EAAEC,kBAAkB,QAAQ,cAAc"}

package/dist/esm/search/search.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Search implementation for MCP capability discovery
+ *
+ * Provides text-based search across tools, prompts, and resources
+ * from connected MCP servers.
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { CapabilityIndex, SearchOptions, SearchResponse } from './types.js';
+export type CapabilityClient = Pick<Client, 'listTools' | 'listPrompts' | 'listResources'>;
+/**
+ * Build an index of capabilities from connected MCP clients
+ */
+export declare function buildCapabilityIndex(clients: Map<string, CapabilityClient>): Promise<CapabilityIndex>;
+/**
+ * Search for capabilities matching a query string
+ */
+export declare function searchCapabilities(index: CapabilityIndex, query: string, options?: SearchOptions): SearchResponse;
+/**
+ * Convenience function to search directly from connected clients
+ * Builds index and performs search in one call
+ */
+export declare function search(clients: Map<string, CapabilityClient>, query: string, options?: SearchOptions): Promise<SearchResponse>;

package/dist/esm/search/search.js

@@ -0,0 +1,236 @@
+/**
+ * Search implementation for MCP capability discovery
+ *
+ * Provides text-based search across tools, prompts, and resources
+ * from connected MCP servers.
+ */ const DEFAULT_LIMIT = 20;
+const DEFAULT_THRESHOLD = 0;
+const DEFAULT_TYPES = [
+    'tool',
+    'prompt',
+    'resource'
+];
+const DEFAULT_SEARCH_FIELDS = [
+    'name',
+    'description',
+    'schema'
+];
+/**
+ * Extract searchable text from a JSON Schema's property descriptions
+ */ function extractSchemaText(inputSchema) {
+    if (!inputSchema || typeof inputSchema !== 'object') {
+        return '';
+    }
+    const schema = inputSchema;
+    const parts = [];
+    // Add schema-level description if present
+    if (schema.description) {
+        parts.push(schema.description);
+    }
+    // Add property names and descriptions
+    if (schema.properties) {
+        for (const [propName, prop] of Object.entries(schema.properties)){
+            parts.push(propName);
+            if (prop && typeof prop === 'object' && prop.description) {
+                parts.push(prop.description);
+            }
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Extract searchable text from prompt arguments
+ */ function extractArgumentsText(args) {
+    if (!args || !Array.isArray(args)) {
+        return '';
+    }
+    return args.map((arg)=>{
+        const parts = [
+            arg.name
+        ];
+        if (arg.description) {
+            parts.push(arg.description);
+        }
+        return parts.join(' ');
+    }).join(' ');
+}
+/**
+ * Build an index of capabilities from connected MCP clients
+ */ export async function buildCapabilityIndex(clients) {
+    const capabilities = [];
+    const servers = [];
+    for (const [serverName, client] of clients){
+        servers.push(serverName);
+        // Fetch all capabilities in parallel, handling errors gracefully
+        const [toolsResult, promptsResult, resourcesResult] = await Promise.all([
+            client.listTools().catch(()=>null),
+            client.listPrompts().catch(()=>null),
+            client.listResources().catch(()=>null)
+        ]);
+        // Index tools
+        if (toolsResult === null || toolsResult === void 0 ? void 0 : toolsResult.tools) {
+            for (const tool of toolsResult.tools){
+                capabilities.push({
+                    type: 'tool',
+                    server: serverName,
+                    name: tool.name,
+                    description: tool.description,
+                    schemaText: extractSchemaText(tool.inputSchema)
+                });
+            }
+        }
+        // Index prompts
+        if (promptsResult === null || promptsResult === void 0 ? void 0 : promptsResult.prompts) {
+            for (const prompt of promptsResult.prompts){
+                capabilities.push({
+                    type: 'prompt',
+                    server: serverName,
+                    name: prompt.name,
+                    description: prompt.description,
+                    argumentsText: extractArgumentsText(prompt.arguments),
+                    arguments: prompt.arguments
+                });
+            }
+        }
+        // Index resources
+        if (resourcesResult === null || resourcesResult === void 0 ? void 0 : resourcesResult.resources) {
+            for (const resource of resourcesResult.resources){
+                capabilities.push({
+                    type: 'resource',
+                    server: serverName,
+                    name: resource.name,
+                    description: resource.description,
+                    uri: resource.uri,
+                    mimeType: resource.mimeType
+                });
+            }
+        }
+    }
+    return {
+        capabilities,
+        servers,
+        indexedAt: new Date()
+    };
+}
+/**
+ * Calculate relevance score and matched fields for a capability against a query
+ */ function scoreCapability(capability, queryTerms, searchFields) {
+    const matchedOn = [];
+    let totalScore = 0;
+    // Weights for different match types
+    const EXACT_NAME_WEIGHT = 1.0;
+    const PARTIAL_NAME_WEIGHT = 0.8;
+    const DESCRIPTION_WEIGHT = 0.6;
+    const SCHEMA_WEIGHT = 0.4;
+    const SERVER_WEIGHT = 0.3;
+    const nameLower = capability.name.toLowerCase();
+    const descLower = (capability.description || '').toLowerCase();
+    const serverLower = capability.server.toLowerCase();
+    // Get schema/arguments text based on type
+    let schemaTextLower = '';
+    if (capability.type === 'tool') {
+        schemaTextLower = capability.schemaText.toLowerCase();
+    } else if (capability.type === 'prompt') {
+        schemaTextLower = capability.argumentsText.toLowerCase();
+    } else if (capability.type === 'resource') {
+        // For resources, include URI and mimeType in searchable text
+        schemaTextLower = `${capability.uri} ${capability.mimeType || ''}`.toLowerCase();
+    }
+    for (const term of queryTerms){
+        const termLower = term.toLowerCase();
+        // Check name matches
+        if (searchFields.includes('name')) {
+            if (nameLower === termLower) {
+                totalScore += EXACT_NAME_WEIGHT;
+                if (!matchedOn.includes('name')) matchedOn.push('name');
+            } else if (nameLower.includes(termLower)) {
+                totalScore += PARTIAL_NAME_WEIGHT;
+                if (!matchedOn.includes('name')) matchedOn.push('name');
+            }
+        }
+        // Check description matches
+        if (searchFields.includes('description') && descLower.includes(termLower)) {
+            totalScore += DESCRIPTION_WEIGHT;
+            if (!matchedOn.includes('description')) matchedOn.push('description');
+        }
+        // Check schema/arguments matches
+        if (searchFields.includes('schema') && schemaTextLower.includes(termLower)) {
+            totalScore += SCHEMA_WEIGHT;
+            const fieldName = capability.type === 'tool' ? 'inputSchema' : capability.type === 'prompt' ? 'arguments' : 'uri';
+            if (!matchedOn.includes(fieldName)) matchedOn.push(fieldName);
+        }
+        // Check server name matches
+        if (searchFields.includes('server') && serverLower.includes(termLower)) {
+            totalScore += SERVER_WEIGHT;
+            if (!matchedOn.includes('server')) matchedOn.push('server');
+        }
+    }
+    // Normalize score to 0-1 range based on number of terms
+    const normalizedScore = queryTerms.length > 0 ? Math.min(1, totalScore / queryTerms.length) : 0;
+    return {
+        score: normalizedScore,
+        matchedOn
+    };
+}
+/**
+ * Search for capabilities matching a query string
+ */ export function searchCapabilities(index, query, options = {}) {
+    const { types = DEFAULT_TYPES, servers, searchFields = DEFAULT_SEARCH_FIELDS, limit = DEFAULT_LIMIT, threshold = DEFAULT_THRESHOLD } = options;
+    // Tokenize query into search terms
+    const queryTerms = query.toLowerCase().split(/\s+/).filter((term)=>term.length > 0);
+    // If empty query, return empty results
+    if (queryTerms.length === 0) {
+        return {
+            query,
+            results: [],
+            total: 0
+        };
+    }
+    // Filter and score capabilities
+    const scoredResults = [];
+    for (const capability of index.capabilities){
+        // Filter by type
+        if (!types.includes(capability.type)) {
+            continue;
+        }
+        // Filter by server
+        if (servers && servers.length > 0 && !servers.includes(capability.server)) {
+            continue;
+        }
+        // Score the capability
+        const { score, matchedOn } = scoreCapability(capability, queryTerms, searchFields);
+        // Apply threshold filter
+        if (score >= threshold && matchedOn.length > 0) {
+            scoredResults.push({
+                capability,
+                score,
+                matchedOn
+            });
+        }
+    }
+    // Sort by score descending
+    scoredResults.sort((a, b)=>b.score - a.score);
+    // Get total before limiting
+    const total = scoredResults.length;
+    // Apply limit and transform to SearchResult
+    const results = scoredResults.slice(0, limit).map(({ capability, score, matchedOn })=>({
+            type: capability.type,
+            server: capability.server,
+            name: capability.name,
+            description: capability.description,
+            matchedOn,
+            score
+        }));
+    return {
+        query,
+        results,
+        total
+    };
+}
+/**
+ * Convenience function to search directly from connected clients
+ * Builds index and performs search in one call
+ */ export async function search(clients, query, options = {}) {
+    const index = await buildCapabilityIndex(clients);
+    return searchCapabilities(index, query, options);
+}

package/dist/esm/search/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/search/search.ts"],"sourcesContent":["/**\n * Search implementation for MCP capability discovery\n *\n * Provides text-based search across tools, prompts, and resources\n * from connected MCP servers.\n */\n\nimport type { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { PromptArgument } from '../connection/types.ts';\nimport type { CapabilityIndex, CapabilityType, IndexedCapability, IndexedPrompt, IndexedResource, IndexedTool, SearchField, SearchOptions, SearchResponse, SearchResult } from './types.ts';\n\nexport type CapabilityClient = Pick<Client, 'listTools' | 'listPrompts' | 'listResources'>;\n\nconst DEFAULT_LIMIT = 20;\nconst DEFAULT_THRESHOLD = 0;\nconst DEFAULT_TYPES: CapabilityType[] = ['tool', 'prompt', 'resource'];\nconst DEFAULT_SEARCH_FIELDS: SearchField[] = ['name', 'description', 'schema'];\n\n/**\n * Extract searchable text from a JSON Schema's property descriptions\n */\nfunction extractSchemaText(inputSchema: unknown): string {\n  if (!inputSchema || typeof inputSchema !== 'object') {\n    return '';\n  }\n\n  const schema = inputSchema as {\n    properties?: Record<string, { description?: string; name?: string }>;\n    description?: string;\n  };\n\n  const parts: string[] = [];\n\n  // Add schema-level description if present\n  if (schema.description) {\n    parts.push(schema.description);\n  }\n\n  // Add property names and descriptions\n  if (schema.properties) {\n    for (const [propName, prop] of Object.entries(schema.properties)) {\n      parts.push(propName);\n      if (prop && typeof prop === 'object' && prop.description) {\n        parts.push(prop.description);\n      }\n    }\n  }\n\n  return parts.join(' ');\n}\n\n/**\n * Extract searchable text from prompt arguments\n */\nfunction extractArgumentsText(args: PromptArgument[] | undefined): string {\n  if (!args || !Array.isArray(args)) {\n    return '';\n  }\n\n  return args\n    .map((arg) => {\n      const parts = [arg.name];\n      if (arg.description) {\n        parts.push(arg.description);\n      }\n      return parts.join(' ');\n    })\n    .join(' ');\n}\n\n/**\n * Build an index of capabilities from connected MCP clients\n */\nexport async function buildCapabilityIndex(clients: Map<string, CapabilityClient>): Promise<CapabilityIndex> {\n  const capabilities: IndexedCapability[] = [];\n  const servers: string[] = [];\n\n  for (const [serverName, client] of clients) {\n    servers.push(serverName);\n\n    // Fetch all capabilities in parallel, handling errors gracefully\n    const [toolsResult, promptsResult, resourcesResult] = await Promise.all([client.listTools().catch(() => null), client.listPrompts().catch(() => null), client.listResources().catch(() => null)]);\n\n    // Index tools\n    if (toolsResult?.tools) {\n      for (const tool of toolsResult.tools) {\n        capabilities.push({\n          type: 'tool',\n          server: serverName,\n          name: tool.name,\n          description: tool.description,\n          schemaText: extractSchemaText(tool.inputSchema),\n        } satisfies IndexedTool);\n      }\n    }\n\n    // Index prompts\n    if (promptsResult?.prompts) {\n      for (const prompt of promptsResult.prompts) {\n        capabilities.push({\n          type: 'prompt',\n          server: serverName,\n          name: prompt.name,\n          description: prompt.description,\n          argumentsText: extractArgumentsText(prompt.arguments as PromptArgument[] | undefined),\n          arguments: prompt.arguments as PromptArgument[] | undefined,\n        } satisfies IndexedPrompt);\n      }\n    }\n\n    // Index resources\n    if (resourcesResult?.resources) {\n      for (const resource of resourcesResult.resources) {\n        capabilities.push({\n          type: 'resource',\n          server: serverName,\n          name: resource.name,\n          description: resource.description,\n          uri: resource.uri,\n          mimeType: resource.mimeType,\n        } satisfies IndexedResource);\n      }\n    }\n  }\n\n  return {\n    capabilities,\n    servers,\n    indexedAt: new Date(),\n  };\n}\n\n/**\n * Calculate relevance score and matched fields for a capability against a query\n */\nfunction scoreCapability(capability: IndexedCapability, queryTerms: string[], searchFields: SearchField[]): { score: number; matchedOn: string[] } {\n  const matchedOn: string[] = [];\n  let totalScore = 0;\n\n  // Weights for different match types\n  const EXACT_NAME_WEIGHT = 1.0;\n  const PARTIAL_NAME_WEIGHT = 0.8;\n  const DESCRIPTION_WEIGHT = 0.6;\n  const SCHEMA_WEIGHT = 0.4;\n  const SERVER_WEIGHT = 0.3;\n\n  const nameLower = capability.name.toLowerCase();\n  const descLower = (capability.description || '').toLowerCase();\n  const serverLower = capability.server.toLowerCase();\n\n  // Get schema/arguments text based on type\n  let schemaTextLower = '';\n  if (capability.type === 'tool') {\n    schemaTextLower = capability.schemaText.toLowerCase();\n  } else if (capability.type === 'prompt') {\n    schemaTextLower = capability.argumentsText.toLowerCase();\n  } else if (capability.type === 'resource') {\n    // For resources, include URI and mimeType in searchable text\n    schemaTextLower = `${capability.uri} ${capability.mimeType || ''}`.toLowerCase();\n  }\n\n  for (const term of queryTerms) {\n    const termLower = term.toLowerCase();\n\n    // Check name matches\n    if (searchFields.includes('name')) {\n      if (nameLower === termLower) {\n        totalScore += EXACT_NAME_WEIGHT;\n        if (!matchedOn.includes('name')) matchedOn.push('name');\n      } else if (nameLower.includes(termLower)) {\n        totalScore += PARTIAL_NAME_WEIGHT;\n        if (!matchedOn.includes('name')) matchedOn.push('name');\n      }\n    }\n\n    // Check description matches\n    if (searchFields.includes('description') && descLower.includes(termLower)) {\n      totalScore += DESCRIPTION_WEIGHT;\n      if (!matchedOn.includes('description')) matchedOn.push('description');\n    }\n\n    // Check schema/arguments matches\n    if (searchFields.includes('schema') && schemaTextLower.includes(termLower)) {\n      totalScore += SCHEMA_WEIGHT;\n      const fieldName = capability.type === 'tool' ? 'inputSchema' : capability.type === 'prompt' ? 'arguments' : 'uri';\n      if (!matchedOn.includes(fieldName)) matchedOn.push(fieldName);\n    }\n\n    // Check server name matches\n    if (searchFields.includes('server') && serverLower.includes(termLower)) {\n      totalScore += SERVER_WEIGHT;\n      if (!matchedOn.includes('server')) matchedOn.push('server');\n    }\n  }\n\n  // Normalize score to 0-1 range based on number of terms\n  const normalizedScore = queryTerms.length > 0 ? Math.min(1, totalScore / queryTerms.length) : 0;\n\n  return { score: normalizedScore, matchedOn };\n}\n\n/**\n * Search for capabilities matching a query string\n */\nexport function searchCapabilities(index: CapabilityIndex, query: string, options: SearchOptions = {}): SearchResponse {\n  const { types = DEFAULT_TYPES, servers, searchFields = DEFAULT_SEARCH_FIELDS, limit = DEFAULT_LIMIT, threshold = DEFAULT_THRESHOLD } = options;\n\n  // Tokenize query into search terms\n  const queryTerms = query\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((term) => term.length > 0);\n\n  // If empty query, return empty results\n  if (queryTerms.length === 0) {\n    return { query, results: [], total: 0 };\n  }\n\n  // Filter and score capabilities\n  const scoredResults: Array<{ capability: IndexedCapability; score: number; matchedOn: string[] }> = [];\n\n  for (const capability of index.capabilities) {\n    // Filter by type\n    if (!types.includes(capability.type)) {\n      continue;\n    }\n\n    // Filter by server\n    if (servers && servers.length > 0 && !servers.includes(capability.server)) {\n      continue;\n    }\n\n    // Score the capability\n    const { score, matchedOn } = scoreCapability(capability, queryTerms, searchFields);\n\n    // Apply threshold filter\n    if (score >= threshold && matchedOn.length > 0) {\n      scoredResults.push({ capability, score, matchedOn });\n    }\n  }\n\n  // Sort by score descending\n  scoredResults.sort((a, b) => b.score - a.score);\n\n  // Get total before limiting\n  const total = scoredResults.length;\n\n  // Apply limit and transform to SearchResult\n  const results: SearchResult[] = scoredResults.slice(0, limit).map(({ capability, score, matchedOn }) => ({\n    type: capability.type,\n    server: capability.server,\n    name: capability.name,\n    description: capability.description,\n    matchedOn,\n    score,\n  }));\n\n  return { query, results, total };\n}\n\n/**\n * Convenience function to search directly from connected clients\n * Builds index and performs search in one call\n */\nexport async function search(clients: Map<string, CapabilityClient>, query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n  const index = await buildCapabilityIndex(clients);\n  return searchCapabilities(index, query, options);\n}\n"],"names":["DEFAULT_LIMIT","DEFAULT_THRESHOLD","DEFAULT_TYPES","DEFAULT_SEARCH_FIELDS","extractSchemaText","inputSchema","schema","parts","description","push","properties","propName","prop","Object","entries","join","extractArgumentsText","args","Array","isArray","map","arg","name","buildCapabilityIndex","clients","capabilities","servers","serverName","client","toolsResult","promptsResult","resourcesResult","Promise","all","listTools","catch","listPrompts","listResources","tools","tool","type","server","schemaText","prompts","prompt","argumentsText","arguments","resources","resource","uri","mimeType","indexedAt","Date","scoreCapability","capability","queryTerms","searchFields","matchedOn","totalScore","EXACT_NAME_WEIGHT","PARTIAL_NAME_WEIGHT","DESCRIPTION_WEIGHT","SCHEMA_WEIGHT","SERVER_WEIGHT","nameLower","toLowerCase","descLower","serverLower","schemaTextLower","term","termLower","includes","fieldName","normalizedScore","length","Math","min","score","searchCapabilities","index","query","options","types","limit","threshold","split","filter","results","total","scoredResults","sort","a","b","slice","search"],"mappings":"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"}

package/dist/esm/search/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Search types for MCP capability discovery
+ *
+ * Enables agents to discover tools, prompts, and resources without
+ * loading full schemas into context.
+ */
+import type { PromptArgument } from '../connection/types.js';
+/**
+ * Types of MCP capabilities that can be searched
+ */
+export type CapabilityType = 'tool' | 'prompt' | 'resource';
+/**
+ * Fields that can be searched within capabilities
+ */
+export type SearchField = 'name' | 'description' | 'schema' | 'server';
+/**
+ * Options for configuring search behavior
+ */
+export interface SearchOptions {
+    /**
+     * Filter to specific capability types
+     * @default ['tool', 'prompt', 'resource']
+     */
+    types?: CapabilityType[];
+    /**
+     * Filter to specific servers by name
+     * @default all servers in config
+     */
+    servers?: string[];
+    /**
+     * Which fields to search within
+     * @default ['name', 'description', 'schema']
+     */
+    searchFields?: SearchField[];
+    /**
+     * Maximum number of results to return
+     * @default 20
+     */
+    limit?: number;
+    /**
+     * Minimum relevance score (0-1) for results
+     * @default 0
+     */
+    threshold?: number;
+}
+/**
+ * A single search result representing a matched capability
+ */
+export interface SearchResult {
+    /** The type of capability */
+    type: CapabilityType;
+    /** The server that provides this capability */
+    server: string;
+    /** The name of the capability */
+    name: string;
+    /** Human-readable description (may be truncated) */
+    description: string | undefined;
+    /** Which fields matched the search query */
+    matchedOn: string[];
+    /** Relevance score from 0 (low) to 1 (high) */
+    score: number;
+}
+/**
+ * Complete search response
+ */
+export interface SearchResponse {
+    /** The original search query */
+    query: string;
+    /** Matching results, sorted by relevance */
+    results: SearchResult[];
+    /** Total number of matches before limit was applied */
+    total: number;
+}
+/**
+ * Internal representation of a tool for indexing
+ */
+export interface IndexedTool {
+    type: 'tool';
+    server: string;
+    name: string;
+    description: string | undefined;
+    /** Flattened searchable text from inputSchema property descriptions */
+    schemaText: string;
+}
+/**
+ * Internal representation of a prompt for indexing
+ */
+export interface IndexedPrompt {
+    type: 'prompt';
+    server: string;
+    name: string;
+    description: string | undefined;
+    /** Flattened searchable text from arguments */
+    argumentsText: string;
+    arguments: PromptArgument[] | undefined;
+}
+/**
+ * Internal representation of a resource for indexing
+ */
+export interface IndexedResource {
+    type: 'resource';
+    server: string;
+    name: string;
+    description: string | undefined;
+    uri: string;
+    mimeType: string | undefined;
+}
+/**
+ * Union of all indexed capability types
+ */
+export type IndexedCapability = IndexedTool | IndexedPrompt | IndexedResource;
+/**
+ * Index containing all capabilities from connected servers
+ */
+export interface CapabilityIndex {
+    /** All indexed capabilities */
+    capabilities: IndexedCapability[];
+    /** Servers that were indexed */
+    servers: string[];
+    /** When the index was created */
+    indexedAt: Date;
+}