status

Instructions

Implementation Reference

• src/server/index.ts:282-287 (registration)

  Registration of the 'status' MCP tool in the ListTools response, defining name, description, and empty input schema.

  {
    name: 'status',
    description:
      'Get system status including total documents, total chunks, database size, and configuration information.',
    inputSchema: { type: 'object', properties: {} },
  },

• src/server/index.ts:618-633 (handler)

  Primary handler function for the 'status' tool. Fetches status data from VectorStore and formats it as JSON text content for MCP response.

  async handleStatus(): Promise<{ content: [{ type: 'text'; text: string }] }> {
    try {
      const status = await this.vectorStore.getStatus()
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(status, null, 2),
          },
        ],
      }
    } catch (error) {
      console.error('Failed to get status:', error)
      throw error
    }
  }

• src/vectordb/index.ts:606-652 (helper)

  Supporting VectorStore.getStatus() method that computes detailed system metrics including document/chunk counts, memory usage, uptime, FTS status, and search mode.

  async getStatus(): Promise<{
    documentCount: number
    chunkCount: number
    memoryUsage: number
    uptime: number
    ftsIndexEnabled: boolean
    searchMode: 'hybrid' | 'vector-only'
  }> {
    if (!this.table) {
      return {
        documentCount: 0,
        chunkCount: 0,
        memoryUsage: 0,
        uptime: process.uptime(),
        ftsIndexEnabled: false,
        searchMode: 'vector-only',
      }
    }
  
    try {
      // Retrieve all records
      const allRecords = await this.table.query().toArray()
      const chunkCount = allRecords.length
  
      // Count unique file paths
      const uniqueFilePaths = new Set(allRecords.map((record) => record.filePath as string))
      const documentCount = uniqueFilePaths.size
  
      // Get memory usage (in MB)
      const memoryUsage = process.memoryUsage().heapUsed / 1024 / 1024
  
      // Get uptime (in seconds)
      const uptime = process.uptime()
  
      return {
        documentCount,
        chunkCount,
        memoryUsage,
        uptime,
        ftsIndexEnabled: this.ftsEnabled,
        searchMode:
          this.ftsEnabled && (this.config.hybridWeight ?? 0.6) > 0 ? 'hybrid' : 'vector-only',
      }
    } catch (error) {
      throw new DatabaseError('Failed to get status', error as Error)
    }
  }

• src/server/index.ts:294-319 (handler)

  Tool dispatching switch statement in CallToolRequestSchema handler that routes 'status' calls to handleStatus().

  async (request: { params: { name: string; arguments?: unknown } }) => {
    switch (request.params.name) {
      case 'query_documents':
        return await this.handleQueryDocuments(
          request.params.arguments as unknown as QueryDocumentsInput
        )
      case 'ingest_file':
        return await this.handleIngestFile(
          request.params.arguments as unknown as IngestFileInput
        )
      case 'ingest_data':
        return await this.handleIngestData(
          request.params.arguments as unknown as IngestDataInput
        )
      case 'delete_file':
        return await this.handleDeleteFile(
          request.params.arguments as unknown as DeleteFileInput
        )
      case 'list_files':
        return await this.handleListFiles()
      case 'status':
        return await this.handleStatus()
      default:
        throw new Error(`Unknown tool: ${request.params.name}`)
    }
  }