Metadata-Version: 2.4
Name: apex-mcp
Version: 0.1.0
Summary: A simple, menu-driven CLI that drives Chrome via the Chrome DevTools MCP server and returns clean JSON. No LLM, no API keys.
Author: Ambar Kaity
License: MIT License
        
        Copyright (c) 2026 Ambar Kaity
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/ambar-kaity/apex-mcp
Project-URL: Chrome DevTools MCP, https://github.com/ChromeDevTools/chrome-devtools-mcp
Keywords: cli,chrome,devtools,mcp,network,automation,api
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: rich>=13.0.0
Dynamic: license-file

# Apex

A simple, menu-driven CLI that drives a real Chrome browser through the
[Chrome DevTools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp)
server and returns clean JSON.

No LLM. No API keys. No tokens. You pick a tool from a menu, answer a few
plain questions, and Apex runs it against Chrome and prints the result.

## How it works

1. `apex --url <url>` launches `chrome-devtools-mcp` as a subprocess.
2. Apex speaks the Model Context Protocol to it over stdio.
3. Chrome opens your URL.
4. Apex shows a grouped, numbered menu of every tool the server offers.
5. You pick a number. Apex asks for any details the tool needs, one at a time.
6. Apex runs the tool and pretty-prints the JSON result. Then back to the menu.

## Requirements

- Python 3.10+
- Node.js LTS (provides `npx`, used to run the MCP server)
- Google Chrome

## Install

```
pip install apex-cli
```

## Usage

```
apex --url "https://www.app.neexus.co.in"
```

Options:

| Flag | Meaning |
|------|---------|
| `--url` | URL to open before the menu appears |
| `--headless` | Run Chrome with no visible window |
| `--isolated` | Use a throwaway Chrome profile |
| `--channel` | `stable`, `beta`, `dev`, or `canary` |
| `--executable-path` | Path to a specific Chrome binary |
| `--version` | Print version and exit |

## Example session

```
$ apex --url "https://app.example.com"
Apex v0.1.0 — connecting to Chrome DevTools MCP...
connected to the MCP server.
loaded 48 tools.
Opening https://app.example.com ...
page opened.

What do you want to do?
Network
  1  list_network_requests   List all network requests for the page
  2  get_network_request     Get details of a single request
Navigation
  3  navigate_page           Navigate the page to a URL
  ...
  q  quit

Pick a number: 1
This tool needs no arguments.
Running list_network_requests...
{ ...pretty JSON result... }
```

## Local development

```
pip install -e .
apex --url "https://example.com"
```
