MCP Search Analytics Server

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:

2. Create a virtual environment:

3. Install dependencies:

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

2. Run the MCP server:

🔐 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]