grok-faf-mcp

Instructions

Implementation Reference

• src/handlers/tools.ts:1272-1301 (handler)

  The handler function that executes the rag_cache_stats tool logic.

    private async handleRagCacheStats(_args: any): Promise<CallToolResult> {
      try {
        const rag = getRAGIntegrator();
        const stats = rag.getCacheStats();
  
        const hitRatePercent = (stats.hitRate * 100).toFixed(1);
  
        const output = `📊 LAZY-RAG Cache Statistics
  
  📦 Cache Size: ${stats.size} entries
  ✅ Cache Hits: ${stats.hits}
  ❌ Cache Misses: ${stats.misses}
  📈 Hit Rate: ${hitRatePercent}%
  🔌 Enabled: ${stats.enabled ? 'Yes' : 'No'}
  
  ${stats.hitRate > 0.5 ? '⚡ Great cache performance!' : stats.size === 0 ? '💡 Cache is empty - queries will populate it' : '📈 Cache warming up...'}`;
  
        return {
          content: [{
            type: 'text',
            text: output
          }]
        };
      } catch (error: unknown) {
        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
        return {
          content: [{
            type: 'text',
            text: `❌ Failed to get cache stats: ${errorMessage}`
          }],

• src/handlers/tools.ts:233-240 (registration)

  Registration definition for the rag_cache_stats tool.

  {
    name: 'rag_cache_stats',
    description: 'Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size',
    inputSchema: {
      type: 'object',
      properties: {}
    }
  },