Remotion Video Generator

Instructions

Search for components by name or description.

Performs a case-insensitive search across component names and descriptions.
Useful when you know what you want but not the exact component name.

Args:
    query: Search term to match against component names and descriptions

Returns:
    JSON object with matching components and their details

Example:
    results = await remotion_search_components(query="text")
    # Returns all components with "text" in name or description
    # (TitleScene, TextOverlay, TextAnimation, etc.)

Implementation Reference

• src/chuk_motion/server.py:101-142 (handler)

  The primary handler implementation for the 'remotion_search_components' tool. This async function searches the COMPONENT_REGISTRY for components matching the query in name, description, or category, and returns results as formatted JSON. The @mcp.tool decorator registers it as an MCP tool.

  @mcp.tool  # type: ignore[arg-type]
  async def remotion_search_components(query: str) -> str:
      """
      Search for components by name or description.
  
      Performs a case-insensitive search across component names and descriptions.
      Useful when you know what you want but not the exact component name.
  
      Args:
          query: Search term to match against component names and descriptions
  
      Returns:
          JSON object with matching components and their details
  
      Example:
          results = await remotion_search_components(query="text")
          # Returns all components with "text" in name or description
          # (TitleScene, TextOverlay, TextAnimation, etc.)
      """
  
      def _search():
          query_lower = query.lower()
          results = {}
  
          for name, comp in COMPONENT_REGISTRY.items():
              # Search in component name
              if query_lower in name.lower():
                  results[name] = comp
                  continue
  
              # Search in description
              if query_lower in comp.get("description", "").lower():
                  results[name] = comp
                  continue
  
              # Search in category
              if query_lower in comp.get("category", "").lower():
                  results[name] = comp
  
          return json.dumps(results, indent=2)
  
      return await asyncio.get_event_loop().run_in_executor(None, _search)

• src/chuk_motion/server.py:101-101 (registration)

  The @mcp.tool decorator on the handler function registers 'remotion_search_components' as an available MCP tool.

  @mcp.tool  # type: ignore[arg-type]