Refactor server into a library for distribution as a PyPI package

Author: hashkode

.cursor/mcp.json

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "browser-use-mcp=server": {
+    "browser-use-mcp-server": {
       "url": "http://localhost:8000/sse"
     }
   }

.env.example

@@ -1,2 +1,5 @@
-OPENAI_API_KEY=sk
-CHROME_PATH=/usr/bin/chromium
+# Path to Chrome/Chromium executable
+/usr/bin/chromium
+
+# OpenAI API key for OpenAI model access
+OPENAI_API_KEY=your-api-key-here

.github/workflows/python-package.yml

@@ -0,0 +1,56 @@
+name: Python Package
+
+on:
+  push:
+    branches: [ main ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install pytest pytest-asyncio pytest-cov
+        pip install -e ".[dev]"
+    - name: Test with pytest
+      run: |
+        pytest --cov=browser_use_mcp_server
+
+  build-and-publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install build twine
+    - name: Build package
+      run: |
+        python -m build
+    - name: Publish to GitHub Packages
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        user: __token__
+        password: ${{ secrets.GITHUB_TOKEN }}
+        repository-url: https://pypi.pkg.github.com/${{ github.repository_owner }} 

pyproject.toml

@@ -1,9 +1,20 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
 [project]
 name = "browser-use-mcp-server"
 version = "0.1.2"
-description = "MCP browser-use server"
+description = "MCP browser-use server library"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.11,<4.0"
+authors = [
+    {name = "Cobrowser Team"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
 dependencies = [
     "asyncio>=3.4.3",
     "browser-use>=0.1.40",
@@ -12,4 +23,52 @@ dependencies = [
     "langchain-openai>=0.3.1",
     "mcp>=1.3.0",
     "pydantic>=2.10.6",
+    "anyio",
+    "python-dotenv",
+    "starlette",
+    "uvicorn",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.1.0",
 ]
+
+[project.urls]
+"Homepage" = "https://github.com/cobrowser/browser-use-mcp-server"
+"Bug Tracker" = "https://github.com/cobrowser/browser-use-mcp-server/issues"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+asyncio_mode = "auto"
+
+[tool.black]
+line-length = 88
+target-version = ["py311"]
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+
+[project.scripts]
+browser-use-mcp-server = "browser_use_mcp_server.cli:cli"
+
+[tool.hatch.build]
+packages = ["src/browser_use_mcp_server"]

server/__init__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+__all__ = ["main"]