MCP Search Analytics

🚀 MCP Search Analytics Server

A Model Context Protocol (MCP) server for analyzing data from Google Analytics and Search Console.

🚀 Quick Start

The MCP Search Analytics Server is designed to provide unified access to Google Analytics 4 and Google Search Console data. It allows real - time analytics queries through the MCP interface and manages credentials securely via environment variables.

✨ 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

📦 Installation

Prerequisites

• Python 3.8+
• Google Cloud Project with Analytics and Search Console APIs enabled
• Google Service Account with appropriate permissions

Steps

1. Clone this repository:

git clone <your-repo-url>
cd mcp-search-analytics

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

Configuration

1. Create environment file:

   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 the .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:

python test_credentials.py

2. Run the MCP server:

python unified_analytics_server.py

🔧 Technical Details

Security Notes

• Never commit credential files (.json, .env) to version control
• Store credentials securely and use environment variables
• Regularly rotate service account keys
• Follow the principle of least privilege for API access

📚 Documentation

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]