mcp-romm

Instructions

Implementation Reference

• server.py:681-705 (handler)

  The handler function `romm_collections` fetches collections data and formats it as a string for the MCP client.

  async def romm_collections() -> str:
      """List user-curated collections."""
      data = await _get("collections")
  
      if not isinstance(data, list) or not data:
          return "No collections found."
  
      lines = [f"Collections ({len(data)}):\n"]
      for c in data:
          name = c.get("name", "Unknown")
          desc = c.get("description", "")
          cid = c.get("id", "?")
          roms = c.get("roms", [])
          rom_count = len(roms) if isinstance(roms, list) else 0
  
          lines.append(f"  {name} ({rom_count} ROM{'s' if rom_count != 1 else ''})")
          if desc:
              short = desc[:100]
              if len(desc) > 100:
                  short += "..."
              lines.append(f"    {short}")
          lines.append(f"    ID: {cid}")
          lines.append("")
  
      return "\n".join(lines)

• server.py:680-680 (registration)

  The `romm_collections` tool is registered using the `@mcp.tool()` decorator.

  @mcp.tool()