Spaces:
Sleeping
Sleeping
File size: 4,564 Bytes
d7b3d84 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 |
"""
Simple example of connecting to browser-use MCP server as a client.
This example demonstrates how to use the MCP client library to connect to
a running browser-use MCP server and call its browser automation tools.
Prerequisites:
1. Install required packages:
pip install 'browser-use[cli]'
2. Start the browser-use MCP server in a separate terminal:
uvx browser-use --mcp
3. Run this client example:
python simple_server.py
This shows the actual MCP protocol flow between a client and the browser-use server.
"""
import asyncio
import json
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from mcp.types import TextContent
async def run_simple_browser_automation():
"""Connect to browser-use MCP server and perform basic browser automation."""
# Create connection parameters for the browser-use MCP server
server_params = StdioServerParameters(command='uvx', args=['browser-use', '--mcp'], env={})
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
# Initialize the connection
await session.initialize()
print('✅ Connected to browser-use MCP server')
# List available tools
tools_result = await session.list_tools()
tools = tools_result.tools
print(f'\n📋 Available tools: {len(tools)}')
for tool in tools:
print(f' - {tool.name}: {tool.description}')
# Example 1: Navigate to a website
print('\n🌐 Navigating to example.com...')
result = await session.call_tool('browser_navigate', arguments={'url': 'https://example.com'})
# Handle different content types
content = result.content[0]
if isinstance(content, TextContent):
print(f'Result: {content.text}')
else:
print(f'Result: {content}')
# Example 2: Get the current browser state
print('\n🔍 Getting browser state...')
result = await session.call_tool('browser_get_state', arguments={'include_screenshot': False})
# Handle different content types
content = result.content[0]
if isinstance(content, TextContent):
state = json.loads(content.text)
else:
state = json.loads(str(content))
print(f'Page title: {state["title"]}')
print(f'URL: {state["url"]}')
print(f'Interactive elements found: {len(state["interactive_elements"])}')
# Example 3: Open a new tab
print('\n📑 Opening Python.org in a new tab...')
result = await session.call_tool('browser_navigate', arguments={'url': 'https://python.org', 'new_tab': True})
# Handle different content types
content = result.content[0]
if isinstance(content, TextContent):
print(f'Result: {content.text}')
else:
print(f'Result: {content}')
# Example 4: List all open tabs
print('\n📋 Listing all tabs...')
result = await session.call_tool('browser_list_tabs', arguments={})
# Handle different content types
content = result.content[0]
if isinstance(content, TextContent):
tabs = json.loads(content.text)
else:
tabs = json.loads(str(content))
for tab in tabs:
print(f' Tab {tab["index"]}: {tab["title"]} - {tab["url"]}')
# Example 5: Click on an element
print('\n👆 Looking for clickable elements...')
state_result = await session.call_tool('browser_get_state', arguments={'include_screenshot': False})
# Handle different content types
content = state_result.content[0]
if isinstance(content, TextContent):
state = json.loads(content.text)
else:
state = json.loads(str(content))
# Find a link to click
link_element = None
for elem in state['interactive_elements']:
if elem['tag'] == 'a' and elem.get('href'):
link_element = elem
break
if link_element:
print(f'Clicking on link: {link_element.get("text", "unnamed")[:50]}...')
result = await session.call_tool('browser_click', arguments={'index': link_element['index']})
# Handle different content types
content = result.content[0]
if isinstance(content, TextContent):
print(f'Result: {content.text}')
else:
print(f'Result: {content}')
print('\n✨ Simple browser automation demo complete!')
async def main():
"""Main entry point."""
print('Browser-Use MCP Client - Simple Example')
print('=' * 50)
print('\nConnecting to browser-use MCP server...\n')
try:
await run_simple_browser_automation()
except Exception as e:
print(f'\n❌ Error: {e}')
print('\nMake sure the browser-use MCP server is running:')
print(" uvx 'browser-use[cli]' --mcp")
if __name__ == '__main__':
asyncio.run(main())
|