Playwright Server MCP

Instructions

Implementation Reference

• src/playwright_server/server.py:249-258 (handler)

  The FillToolHandler class provides the core implementation for the 'playwright_fill' tool. It checks for an active session, retrieves the current page, locates the input element using the provided CSS selector, fills it with the specified value using Playwright's fill method, and returns a confirmation message.
  class FillToolHandler(ToolHandler): async def handle(self, name: str, arguments: dict | None) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]: if not self._sessions: return [types.TextContent(type="text", text="No active session. Please create a new session first.")] session_id = list(self._sessions.keys())[-1] page = self._sessions[session_id]["page"] selector = arguments.get("selector") value = arguments.get("value") await page.locator(selector).fill(value) return [types.TextContent(type="text", text=f"Filled element with selector {selector} with value {value}")]
• src/playwright_server/server.py:98-109 (schema)

  The JSON Schema for the 'playwright_fill' tool, defining required string inputs 'selector' (CSS selector for the input field) and 'value' (text to fill in), as returned by the list_tools handler.
  types.Tool( name="playwright_fill", description="Fill out an input field", inputSchema={ "type": "object", "properties": { "selector": {"type": "string", "description": "CSS selector for input field"}, "value": {"type": "string", "description": "Value to fill"} }, "required": ["selector", "value"] } ),
• src/playwright_server/server.py:338-338 (registration)

  Registration of the 'playwright_fill' tool by mapping its name to an instance of FillToolHandler in the tool_handlers dictionary, which is used by the @server.call_tool() handler to execute the tool.
  "playwright_fill": FillToolHandler(),