MCP Utility Tools

Instructions

Implementation Reference

• src/index.ts:341-354 (handler)

  Handler implementation for the cache_clear tool. Clears the entire cache using cache.clear() and returns the number of entries cleared before clearing.

  case "cache_clear": {
    const size = cache.size;
    cache.clear();
    
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          cleared_entries: size
        })
      }]
    };
  }

• src/index-v2.ts:482-519 (handler)

  Enhanced handler for cache_clear tool supporting optional namespace clearing. Iterates and deletes keys with matching prefix if namespace provided, otherwise clears all. Returns count of cleared entries.

  case "cache_clear": {
    const { namespace } = args as any;
    
    if (namespace) {
      let cleared = 0;
      const prefix = `${namespace}:`;
      for (const key of cache.keys()) {
        if (key.startsWith(prefix)) {
          cache.delete(key);
          cleared++;
        }
      }
      
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            success: true,
            namespace,
            cleared_entries: cleared
          })
        }]
      };
    } else {
      const size = cache.size;
      cache.clear();
      
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            success: true,
            cleared_entries: size
          })
        }]
      };
    }
  }

• src/index.ts:136-143 (registration)

  Tool registration in the tools list, including name, description, and empty input schema.

  {
    name: "cache_clear",
    description: "Clear all entries from the cache",
    inputSchema: {
      type: "object",
      properties: {}
    }
  },

• src/index-v2.ts:163-175 (registration)

  Tool registration for v2 with support for namespace parameter in input schema.

  {
    name: "cache_clear",
    description: "Clear all entries from the cache or a specific namespace",
    inputSchema: {
      type: "object",
      properties: {
        namespace: {
          type: "string",
          description: "Clear only this namespace, or all if not specified"
        }
      }
    }
  },

• src/index.ts:18-18 (helper)

  Cache storage Map used by cache_clear and other cache tools. Defined identically in index-v2.ts.

  const cache = new Map<string, CacheEntry>();