MCP Memento

Instructions

Implementation Reference

• src/memento/tools/relationship_tools.py:80-127 (handler)

  The actual handler implementation for 'get_related_mementos', which retrieves related memories from the SQLite database.

  async def handle_get_related_mementos(
      memory_db: SQLiteMemoryDatabase, arguments: Dict[str, Any]
  ) -> CallToolResult:
      """Handle get_related_memories tool call.
  
      Args:
          memory_db: Database instance for memory operations
          arguments: Tool arguments from MCP call containing:
              - memory_id: ID of memory to find relations for
              - relationship_types: Optional list of relationship types to filter
              - max_depth: Optional maximum traversal depth (default: 2)
  
      Returns:
          CallToolResult with list of related memories or error message
      """
      memory_id = arguments["memory_id"]
      relationship_types = None
  
      if "relationship_types" in arguments:
          relationship_types = [
              RelationshipType(t) for t in arguments["relationship_types"]
          ]
  
      max_depth = arguments.get("max_depth", 2)
  
      related_memories = await memory_db.get_related_memories(
          memory_id=memory_id, relationship_types=relationship_types, max_depth=max_depth
      )
  
      if not related_memories:
          return CallToolResult(
              content=[
                  TextContent(
                      type="text", text=f"No related memories found for: {memory_id}"
                  )
              ]
          )
  
      # Format results
      results_text = f"Found {len(related_memories)} related memories:\n\n"
      for i, (memory, relationship) in enumerate(related_memories, 1):
          results_text += f"**{i}. {memory.title}** (ID: {memory.id})\n"
          results_text += f"Relationship: {relationship.type.value} (strength: {relationship.properties.strength})\n"
          results_text += (
              f"Type: {memory.type.value} | Importance: {memory.importance}\n\n"
          )
  
      return CallToolResult(content=[TextContent(type="text", text=results_text)])