mcp-romm

Instructions

Implementation Reference

• server.py:867-897 (handler)

  The handler function `romm_rom_notes` fetches notes for a specific ROM ID from the API and formats them into a string.

  @mcp.tool()
  async def romm_rom_notes(rom_id: int) -> str:
      """View notes on a ROM.
  
      rom_id: The ROM's ID (from romm_library_items or romm_search).
      """
      data = await _get(f"roms/{rom_id}/notes")
  
      if not isinstance(data, list) or not data:
          return f"No notes found for ROM {rom_id}."
  
      lines = [f"Notes for ROM {rom_id} ({len(data)}):\n"]
      for n in data:
          body = n.get("raw_markdown") or n.get("body", "")
          created = n.get("created_at", "")
          updated = n.get("updated_at", "")
          note_id = n.get("id", "?")
  
          if body:
              short = body[:300]
              if len(body) > 300:
                  short += "..."
              lines.append(f"  [{note_id}] {short}")
          if created:
              line = f"    Created: {created}"
              if updated and updated != created:
                  line += f" | Updated: {updated}"
              lines.append(line)
          lines.append("")
  
      return "\n".join(lines)