MCP Search Analytics

🚀 MCP搜索分析服務器

這是一個用於谷歌分析（Google Analytics）和搜索控制檯（Search Console）數據分析的模型上下文協議（MCP）服務器。它能幫助用戶統一訪問相關數據，並進行實時分析查詢。

✨ 主要特性

• 統一訪問谷歌分析4（Google Analytics 4）和谷歌搜索控制檯的數據。
• 通過MCP接口進行實時分析查詢。
• 通過環境變量實現安全的憑證管理。

📦 安裝指南

前提條件

• Python 3.8 及以上版本。
• 啟用了分析和搜索控制檯 API 的谷歌雲項目。
• 具有適當權限的谷歌服務賬戶。

安裝步驟

1. 克隆此倉庫：

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

2. 創建虛擬環境：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用：venv\Scripts\activate

3. 安裝依賴項：

pip install -r requirements.txt

配置步驟

1. 創建環境文件：

cp environment.example .env

2. 設置谷歌服務賬戶：

   • 在谷歌雲控制檯創建一個服務賬戶。
   • 下載 JSON 憑證文件。
   • 啟用谷歌分析報告 API 和搜索控制檯 API。
   • 為你的服務賬戶授予必要的權限。

3. 配置環境變量： 編輯 .env 文件並填入實際值：

ANALYTICS_CREDENTIALS_PATH=/path/to/your/credentials.json
GSC_SITE_URL=https://your-website.com
GA4_PROPERTY_ID=your-property-id

使用方法

1. 測試你的憑證：

python test_credentials.py

2. 運行 MCP 服務器：

python unified_analytics_server.py

🔐 安全注意事項

• 切勿將憑證文件（.json、.env）提交到版本控制中。
• 安全地存儲憑證並使用環境變量。
• 定期輪換服務賬戶密鑰。
• 遵循最小權限原則進行 API 訪問。

📋 依賴要求

Python 依賴項請參考 requirements.txt 文件。

🤝 貢獻指南

1. 分叉此倉庫。
2. 創建一個功能分支。
3. 進行修改。
4. 進行全面測試。
5. 提交拉取請求。

📄 許可證

[在此添加你的許可證信息]