Documentation Search MCP Server

Instructions

Clear the documentation cache to force fresh fetches.

Returns:
    Status message about cache clearing

Implementation Reference

• src/documentation_search_enhanced/main.py:775-788 (handler)

  The MCP tool handler function for 'clear_cache'. It clears the SimpleCache instance if caching is enabled and returns a status message with the number of entries cleared.

  @mcp.tool()
  async def clear_cache():
      """
      Clear the documentation cache to force fresh fetches.
  
      Returns:
          Status message about cache clearing
      """
      if cache:
          entries_cleared = await cache.clear()
          return f"Cache cleared. Removed {entries_cleared} cached entries."
      else:
          return "Caching is not enabled."

• src/documentation_search_enhanced/main.py:184-189 (helper)

  The 'clear' method of the SimpleCache class, invoked by the clear_cache tool handler to remove all cached entries and persist the empty state if persistence is enabled.

  async def clear(self) -> int:
      async with self._lock:
          removed = len(self.cache)
          self.cache.clear()
          await self._persist_locked()

• src/documentation_search_enhanced/main.py:775-775 (registration)

  The @mcp.tool() decorator registers the clear_cache function as an MCP tool.

  @mcp.tool()