feat!: add 'google-analytics-mcp' command for pipx compatibility (#9)

Simplifies the process of running the server by utilizing `pipx`.

- Added pix to commands in README
- Added instructions on local testing to the contributing guide

BREAKING_CHANGE: `server.py` moved into the `analytics_mcp` package

Author: jradcliff

CONTRIBUTING.md

@@ -43,3 +43,14 @@ Then run the formatter on all Python files:
 ```
 nox -s format
 ```
+
+## Test changes
+
+To test changes, modify the `command` for the `analytics-mcp` entry in your
+`~/.gemini/settings.json` file so Gemini runs the server using your local
+source files:
+
+```
+      "command": "PATH_TO_REPO/.venv/bin/google-analytics-mcp",
+```
+

README.md

@@ -51,38 +51,13 @@ to provide several
 
 Setup involves the following steps:
 
-1.  Clone the repo.
-1.  Configure Python and install dependencies.
+1.  Configure Python.
 1.  Configure credentials for Google Analytics.
 1.  Configure Gemini.
 
-### Clone the repo
-
-```
-git clone https://github.com/googleanalytics/google-analytics-mcp.git
-```
-
 ### Configure Python :snake:
 
-Navigate to the `google-analytics-mcp` directory, then complete the following steps.
-
-1.  Create a Python virtual environment in the `env` directory.
-
-    ```shell
-    python3 -m venv .venv
-    ```
-
-1.  Activate the virtual environment.
-
-    ```shell
-    source .venv/bin/activate
-    ```
-
-1.  Setup the project and its dependencies.
-
-    ```shell
-    pip install .
-    ```
+[Install pipx](https://pipx.pypa.io/stable/#install-pipx).
 
 ### Configure credentials :key:
 
@@ -132,20 +107,17 @@ Here are some sample `gcloud` commands you might find useful:
 1.  Create or edit the file at `~/.gemini/settings.json`, adding your server
     to the `mcpServers` list.
 
-    Replace `PATH_TO_SERVER` with the complete path to the directory where you
-    cloned this repo.
-
     ```
     {
       "mcpServers": {
         "analytics-mcp": {
-          "command": "PATH_TO_SERVER/.venv/bin/python",
+          "command": "pipx",
           "args": [
-            "PATH_TO_SERVER/server.py"
-          ],
-          "env": {
-            "MCP_DEBUG": "true"
-          }
+            "run",
+            "--spec",
+            "git+https://github.com/googleanalytics/google-analytics-mcp.git",
+            "google-analytics-mcp"
+          ]
         }
       },
       "selectedAuthType": "gemini-api-key",
@@ -169,9 +141,12 @@ Here are some sample `gcloud` commands you might find useful:
     {
       "mcpServers": {
         "analytics-mcp": {
-          "command": "PATH_TO_SERVER/.venv/bin/python",
+          "command": "pipx",
           "args": [
-            "PATH_TO_SERVER/server.py"
+            "run",
+            "--spec",
+            "git+https://github.com/googleanalytics/google-analytics-mcp.git",
+            "google-analytics-mcp"
           ],
           "env": {
             "MCP_DEBUG": "true",

server.py analytics_mcp/server.pyserver.py renamed to analytics_mcp/server.py

@@ -26,5 +26,14 @@
 from analytics_mcp.tools.reporting import realtime  # noqa: F401
 from analytics_mcp.tools.reporting import core  # noqa: F401
 
-if __name__ == "__main__":
+
+def run_server() -> None:
+    """Runs the server.
+
+    Serves as the entrypoint for the 'runmcp' command.
+    """
     mcp.run()
+
+
+if __name__ == "__main__":
+    run_server()

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "analytics-mcp"
+name = "google-analytics-mcp"
 version = "0.1.0"
 requires-python = ">=3.9, <3.14"
 license = "Apache-2.0"
@@ -11,6 +11,9 @@ dependencies = [
     "httpx>=0.28.1"
 ]
 
+[project.scripts]
+google-analytics-mcp = "analytics_mcp.server:run_server"
+
 [project.optional-dependencies]
 dev = [
     "black",