MCP Memento

Instructions

Implementation Reference

• src/memento/tools/activity_tools.py:215-304 (handler)

  Handler implementation for search_memento_relationships_by_context. It takes database arguments and formats results into TextContent.

  async def handle_search_memento_relationships_by_context(
      memory_db: SQLiteMemoryDatabase, arguments: Dict[str, Any]
  ) -> CallToolResult:
      """Handle search_relationships_by_context tool call.
  
      Args:
          memory_db: Database instance for memory operations
          arguments: Tool arguments from MCP call containing:
              - scope: Filter by scope (partial/full/conditional, optional)
              - conditions: Filter by conditions (optional)
              - has_evidence: Filter by presence/absence of evidence (optional)
              - evidence: Filter by specific evidence types (optional)
              - components: Filter by components mentioned (optional)
              - temporal: Filter by temporal information (optional)
              - limit: Maximum results (default: 20)
  
      Returns:
          CallToolResult with formatted relationship results or error message
      """
      # Check if database supports search_relationships_by_context method
      if not hasattr(memory_db, "search_relationships_by_context"):
          return CallToolResult(
              content=[
                  TextContent(
                      type="text",
                      text="Context-based relationship search is not supported by this backend",
                  )
              ],
              isError=True,
          )
  
      relationships = await memory_db.search_relationships_by_context(
          scope=arguments.get("scope"),
          conditions=arguments.get("conditions"),
          has_evidence=arguments.get("has_evidence"),
          evidence=arguments.get("evidence"),
          components=arguments.get("components"),
          temporal=arguments.get("temporal"),
          limit=arguments.get("limit", 20),
      )
  
      if not relationships:
          return CallToolResult(
              content=[
                  TextContent(
                      type="text",
                      text="No relationships found matching the specified context criteria",
                  )
              ]
          )
  
      # Format results
      result_text = (
          f"**Found {len(relationships)} relationships matching context criteria**\n\n"
      )
  
      # Show applied filters
      filters_applied = []
      if arguments.get("scope"):
          filters_applied.append(f"Scope: {arguments['scope']}")
      if arguments.get("conditions"):
          filters_applied.append(f"Conditions: {', '.join(arguments['conditions'])}")
      if arguments.get("has_evidence") is not None:
          filters_applied.append(f"Has Evidence: {arguments['has_evidence']}")
      if arguments.get("evidence"):
          filters_applied.append(f"Evidence: {', '.join(arguments['evidence'])}")
      if arguments.get("components"):
          filters_applied.append(f"Components: {', '.join(arguments['components'])}")
      if arguments.get("temporal"):
          filters_applied.append(f"Temporal: {arguments['temporal']}")
  
      if filters_applied:
          result_text += "**Filters Applied:**\n"
          for f in filters_applied:
              result_text += f"- {f}\n"
          result_text += "\n"
  
      # List relationships
      for i, rel in enumerate(relationships, 1):
          result_text += f"{i}. **{rel.type.value}**\n"
          result_text += f"   - ID: {rel.id}\n"
          result_text += f"   - From: {rel.from_memory_id}\n"
          result_text += f"   - To: {rel.to_memory_id}\n"
          result_text += f"   - Strength: {rel.properties.strength:.2f}\n"
          if rel.properties.context:
              result_text += f"   - Context: {rel.properties.context}\n"
          result_text += "\n"
  
      return CallToolResult(content=[TextContent(type="text", text=result_text)])