Lspace MCP Server

Instructions

Implementation Reference

• lspace-mcp-server.js:241-263 (registration)

  Tool registration entry defining name, description, and input schema

  {
    name: "lspace_list_knowledge_base_history",
    description: "📜 HISTORY: List all changes made to the knowledge base in human-friendly format. Shows both file uploads and knowledge base generations separately. Example: repositoryId='b3fcb584-5fd9-4098-83b8-8c5d773d86eb'",
    inputSchema: {
      type: "object",
      properties: {
        repositoryId: {
          type: "string",
          description: "The ID of the Lspace repository. Use 'lspace_list_repositories' first to get repository IDs."
        },
        limit: {
          type: "number",
          description: "Maximum number of changes to return (default: 20)"
        },
        changeType: {
          type: "string",
          description: "Filter by type of change: 'file_upload', 'knowledge_base_generation', or 'both'",
          enum: ["file_upload", "knowledge_base_generation", "both"]
        }
      },
      required: ["repositoryId"]
    }
  },

• lspace-mcp-server.js:868-908 (handler)

  MCP server handler for the tool: validates input, calls KnowledgeBaseHistoryService.listKnowledgeBaseChanges, formats response, handles errors

  case 'lspace_list_knowledge_base_history':
    const { repositoryId: historyRepoId, limit: historyLimit, changeType } = args;
    if (!historyRepoId) {
      return {
        jsonrpc: "2.0",
        id,
        error: {
          code: -32000,
          message: `Missing required parameter: repositoryId. Use 'lspace_list_repositories' to get repository IDs.`
        }
      };
    }
  
    try {
      const changes = await this.historyService.listKnowledgeBaseChanges(historyRepoId, {
        limit: historyLimit || 20,
        changeType: changeType || 'both'
      });
  
      return {
        jsonrpc: "2.0",
        id,
        result: {
          content: [
            {
              type: "text",
              text: this.formatHistoryResponse(changes, changeType || 'both')
            }
          ]
        }
      };
    } catch (error) {
      return {
        jsonrpc: "2.0",
        id,
        error: {
          code: -32000,
          message: `Error retrieving history: ${error.message}`
        }
      };
    }

• lspace-mcp-server.js:977-1004 (helper)

  Helper function to format history changes into human-readable text response

  formatHistoryResponse(changes, changeType) {
    if (changes.length === 0) {
      return `No ${changeType === 'both' ? '' : changeType + ' '}changes found in the knowledge base history.`;
    }
  
    let response = `Knowledge Base History (${changes.length} change${changes.length === 1 ? '' : 's'}):\n\n`;
    
    changes.forEach((change, index) => {
      const typeIcon = change.changeType === 'file_upload' ? '📄' : '🧠';
      const operationIcon = change.operation === 'added' ? '➕' : change.operation === 'updated' ? '✏️' : '🗑️';
      
      response += `${index + 1}. ${typeIcon} ${operationIcon} ${change.description}\n`;
      response += `   ID: ${change.id}\n`;
      response += `   When: ${change.userFriendlyDate}\n`;
      response += `   Type: ${change.changeType.replace('_', ' ')}\n`;
      if (change.details?.user) response += `   User: ${change.details.user}\n`;
      if (change.filesAffected.length > 0) response += `   Files: ${change.filesAffected.join(', ')}\n`;
      response += '\n';
    });
  
    response += `💡 Use 'lspace_undo_knowledge_base_changes' to revert any of these changes.\n`;
    response += `📋 Refer to changes by their ID or use human-friendly commands like:\n`;
    response += `   • "undo changes for filename.txt"\n`;
    response += `   • "undo last 3 changes"\n`;
    response += `   • revertType options: 'file_upload', 'knowledge_base_generation', 'both'`;
  
    return response;
  }

• src/services/knowledgeBaseHistoryService.ts:56-81 (handler)

  Core implementation: retrieves timeline history, converts to KnowledgeBaseChange objects distinguishing file uploads and KB generations, applies filters

  async listKnowledgeBaseChanges(
    repositoryId: string,
    options: { 
      limit?: number; 
      includeDetails?: boolean;
      changeType?: 'file_upload' | 'knowledge_base_generation' | 'both';
    } = {}
  ): Promise<KnowledgeBaseChange[]> {
    const repository = this.repositoryManager.getRepository(repositoryId);
    
    const filterOptions: TimelineFilterOptions = {
      limit: options.limit || 20,
      offset: 0
    };
  
    const historyEntries = await this.timelineService.getDetailedHistoryEntries(repository, filterOptions);
    
    const changes = historyEntries.flatMap(entry => this.convertToKnowledgeBaseChanges(entry));
    
    // Filter by change type if specified
    if (options.changeType && options.changeType !== 'both') {
      return changes.filter(change => change.changeType === options.changeType);
    }
    
    return changes;
  }

• src/services/knowledgeBaseHistoryService.ts:5-22 (schema)

  Type definition for KnowledgeBaseChange used in history listing

  export interface KnowledgeBaseChange {
    id: string;
    timestamp: string;
    description: string; // Human-friendly description
    operation: 'added' | 'updated' | 'removed' | 'organized';
    changeType: 'file_upload' | 'knowledge_base_generation'; // Key distinction!
    filesAffected: string[];
    userFriendlyDate: string;
    canRevert: boolean;
    internalCommitId: string;
    relatedCommitId?: string; // Links file upload to its KB generation
    details?: {
      title?: string;
      user?: string;
      category?: string;
      sourceFile?: string; // For KB changes, which file triggered them
    };
  }