https://github.com/dexter480/mcp-search-analytics
MCP server for GA and GSC data analysis
https://github.com/dexter480/mcp-search-analytics
Last synced: 3 months ago
JSON representation
MCP server for GA and GSC data analysis
- Host: GitHub
- URL: https://github.com/dexter480/mcp-search-analytics
- Owner: dexter480
- Created: 2025-06-05T12:14:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-14T02:44:45.000Z (4 months ago)
- Last Synced: 2025-06-14T03:35:16.144Z (4 months ago)
- Language: Python
- Homepage:
- Size: 6.84 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-search-analytics** - MCP server for GA and GSC data analysis `python` `mcp` `server` `pip install git+https://github.com/dexter480/mcp-search-analytics` (AI/ML)
- awesome-mcp-servers - **mcp-search-analytics** - MCP server for GA and GSC data analysis `python` `mcp` `server` `pip install git+https://github.com/dexter480/mcp-search-analytics` (AI/ML)
README
# MCP Search Analytics Server
A Model Context Protocol (MCP) server for Google Analytics and Search Console data analysis.
## 🚀 Features
- Unified access to Google Analytics 4 and Google Search Console data
- Real-time analytics queries through MCP interface
- Secure credential management via environment variables
## 🔧 Setup
### Prerequisites
- Python 3.8+
- Google Cloud Project with Analytics and Search Console APIs enabled
- Google Service Account with appropriate permissions
### Installation
1. Clone this repository:
```bash
git clone
cd mcp-search-analytics
```
2. Create a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
### Configuration
1. **Create environment file:**
```bash
cp environment.example .env
```
2. **Set up Google Service Account:**
- Create a service account in Google Cloud Console
- Download the JSON credentials file
- Enable Google Analytics Reporting API and Search Console API
- Grant necessary permissions to your service account
3. **Configure environment variables:**
Edit `.env` file with your actual values:
```
ANALYTICS_CREDENTIALS_PATH=/path/to/your/credentials.json
GSC_SITE_URL=https://your-website.com
GA4_PROPERTY_ID=your-property-id
```
### Usage
1. Test your credentials:
```bash
python test_credentials.py
```
2. Run the MCP server:
```bash
python unified_analytics_server.py
```
## 🔐 Security Notes
- **Never commit credential files** (`.json`, `.env`) to version control
- Store credentials securely and use environment variables
- Regularly rotate service account keys
- Follow principle of least privilege for API access
## 📋 Requirements
See `requirements.txt` for Python dependencies.
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
## 📄 License
[Add your license here]