Skip to content

docs: add Claude Code and Cursor setup examples; fix bare except #146

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ZLeventer wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add Claude Code and Cursor setup examples; fix bare except #146

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 37 additions & 11 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,14 @@ following message. You'll need this for the next step!
Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
```

### Configure Gemini
### Configure your MCP client

Add the server to your MCP client's configuration. Replace
`PATH_TO_CREDENTIALS_JSON` with the path you copied in the previous step, and
`YOUR_PROJECT_ID` with your
[Google Cloud project ID](https://support.google.com/googleapi/answer/7014113).

#### Gemini CLI / Gemini Code Assist

1. Install [Gemini
CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/installation.md)
Expand All @@ -124,14 +131,6 @@ Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
1. Create or edit the file at `~/.gemini/settings.json`, adding your server
to the `mcpServers` list.

Replace `PATH_TO_CREDENTIALS_JSON` with the path you copied in the previous
step.

We also recommend that you add a `GOOGLE_CLOUD_PROJECT` attribute to the
`env` object. Replace `YOUR_PROJECT_ID` in the following example with the
[project ID](https://support.google.com/googleapi/answer/7014113) of your
Google Cloud project.

```json
{
"mcpServers": {
Expand All @@ -150,10 +149,37 @@ Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
}
```

#### Claude Code (Anthropic)

Add to your project's `.mcp.json` or `~/.claude/settings.json`:

```json
{
"mcpServers": {
"analytics-mcp": {
"command": "pipx",
"args": [
"run",
"analytics-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
"GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
}
}
}
}
```

#### Cursor / VS Code (Copilot)

Add to `.cursor/mcp.json` or `.vscode/mcp.json` in your project root using
the same `mcpServers` format shown above.

## Try it out 🥼

Launch Gemini Code Assist or Gemini CLI and type `/mcp`. You should see
`analytics-mcp` listed in the results.
Launch your MCP client. You should see `analytics-mcp` listed in the
available servers.

Here are some sample prompts to get you started:

Expand Down
2 changes: 1 addition & 1 deletion analytics_mcp/tools/utils.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ def _get_package_version_with_fallback():
"""
try:
return metadata.version("analytics-mcp")
except:
except Exception:
return "unknown"


Expand Down