Metadata-Version: 2.4
Name: maestro-mcp
Version: 0.1.0
Summary: The Official Maestro MCP for Claude Desktop, Cursor and other MCP clients.
Project-URL: Homepage, https://github.com/mobile-dev-inc/maestro-mcp
Project-URL: Bug Tracker, https://github.com/mobile-dev-inc/maestro-mcp/issues
Project-URL: Documentation, https://docs.maestro.dev
Author-email: herval <hervalfreire@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: automation,maestro,mcp,mobile,testing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Acceptance
Requires-Python: >=3.11
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# Maestro MCP

A Python package for Maestro MCP.

## Installation

You can install the package via pip:

```bash
pip install maestro-mcp
```

## Development

This project uses `uv` for dependency management.

### Using UV

Install `uv` globally:

```bash
brew install uv
```

To install dependencies, run:

```bash
uv venv
source .venv/bin/activate
uv pip install -e .
uv pip install -e ".[dev]"
```

To run the application, use:

```bash
uv run --with "mcp[cli]" --with "requests" mcp run src/maestro_mcp/cli.py
```

## Configuring the MCP on Claude, Windsurf, etc

Include the following on Claude's config file:

```
{
  "mcpServers": {
    "maestro": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "uv",
        "--with",
        "requests",
        "mcp",
        "run",
        "<full path to maestro_mcp/cli.py>"
      ],
      "env": {
        "MAESTRO_BINARY_PATH": "<path to the maestro executable - usually ~/.maestro/bin/maestro>"
        "MAESTRO_API_KEY": "<your maestro api key - you can get this from your maestro.dev account. It'll be automatically looked up after you run `maestro login`>"
      }
    }
  }
}
```

Install locally with:

```
 uv run --with "mcp[cli]" mcp install -v MAESTRO_API_KEY="<your api key>" -v MAESTRO_BINARY_PATH="~/.maestro/bin/maestro" src/maestro_mcp/cli.py
```
