amal-alexander/mcp

---

🤔 What Is This?

This is a Model Context Protocol (MCP) server: a bridge that gives AI assistants direct, live access to your SEO data platforms.

Instead of:

• Logging into 4 dashboards
• Exporting CSVs
• Copy-pasting data into ChatGPT/Claude
• Waiting for reports

You just open Claude Desktop and ask:

“Why did my traffic drop last week and which pages are responsible?”

The MCP server fetches the live data, runs the analysis, and gives you an answer in seconds. No spreadsheets. No exports. No switching tabs.

---

🔌 Works With Claude Desktop (Primary) + Other MCP Clients

Important: This server uses the Model Context Protocol (MCP), an open standard by Anthropic. It is primarily designed for Claude Desktop, which has the most complete and polished MCP support. It also works with other MCP-compatible clients:

Not compatible with: ChatGPT, Gemini, raw API calls, or browser-based AI tools, as those do not support the MCP protocol.

---

✨ What You Can Do (Magic Prompts)

Paste any of these into Claude Desktop after setup:

"My traffic dropped this week, find exactly when it started and which pages are responsible."

"Find keywords where I rank 8-15 with over 1,000 impressions. These are my quick wins."

"Are any of my pages cannibalizing each other for the same keyword? Which should be primary?"

"Compare my Google vs Bing performance. Where am I stronger on Bing?"

"Run a full SEO health check. Give me 3 high-impact actions for this week."

"Which of my top pages have high impressions but terrible CTR? Fix the titles."

"Correlate my PageSpeed scores with ranking drops. Is slow speed hurting me?"

---

📦 Platforms Connected

---

⚡ Quick Start (5 Steps)

Requirements: Node.js 18+, npm, Windows/macOS/Linux, Claude Desktop installed

Step 1: Clone & Install

git clone https://github.com/amal-alexander/mcp.git
cd mcp
npm install

Step 2: Build

npm run build

Step 3: Run the Setup Wizard

node dist\index.js setup

You’ll see an interactive menu:

╭──────────────────────────────────────────────╮
│              MCP: Setup Wizard               │
│  GSC · Google Analytics 4 · Bing · Adobe     │
│            Built by Amal Alexander            │
╰──────────────────────────────────────────────╯

Let's wire this up. Pick your integration.

1. Google Search Console
2. Google Analytics 4
3. Bing Webmaster Tools
4. Adobe Analytics
5. Exit

Pick each platform you want to connect. You can run it multiple times to add more.

Step 4: Add to Claude Desktop Config

The wizard prints the exact JSON to paste. Open this file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Paste this:

{
  "mcpServers": {
    "mcp-amal-alexander": {
      "command": "node",
      "args": ["C:/full/path/to/mcp/dist/index.js"]
    }
  }
}

Use forward slashes in the path, even on Windows. Replace with your actual clone location.

Step 5: Restart Claude Desktop & Test

Restart Claude Desktop. You’ll see the 🔧 tools icon appear. Then ask:

“List my top 10 pages by impressions from Google Search Console for the last 30 days.”

If you get data back: you’re live! 🎉

---

🛠️ Platform Setup Details

---

📊 Expected Output When Connected

Here’s what Claude can tell you the moment it’s connected:

You: "Run a health check on my site."

Claude: Here's your SEO health check for example.com (last 28 days):

📈 Performance Overview
  • Total Clicks: 12,450 (+8.3% vs previous period)
  • Total Impressions: 284,000 (+2.1%)
  • Average CTR: 4.38% (down from 4.71%)
  • Average Position: 18.4

⚠️ Anomalies Detected
  • Traffic drop on June 14: clicks fell 34% on /blog/guides/*
  • Correlates with Google algorithm update (June 13)

🎯 Top 3 Quick Wins
  1. /pricing: ranking #9 with 8,200 impressions. One push to top-5 = ~3,200 extra clicks/month
  2. /features: CTR of 1.2% at position #3, meta description likely needs rewriting
  3. /blog/seo-tips is cannibalized by /resources/seo-guide, consolidate these pages

---

🛡️ Security & Privacy

• 100% Local: all credentials stay on your machine. Zero cloud storage.
• System Keychain: Google tokens stored in Windows Credential Manager / macOS Keychain
• AES-256-GCM Encryption: all other credentials encrypted with your hardware machine ID
• No middleman: API calls go directly from your machine to Google/Bing/Adobe

---

🔧 Troubleshooting

---

🗺️ Full Tools Reference

---

🏗️ Architecture

graph TD
    Claude[Claude Desktop ⭐] -- MCP Stdio --> Server[MCP Server]
    Cursor[Cursor IDE] -- MCP Stdio --> Server
    Server -- Keychain API --> Keys[System Keychain]
    Server -- AES-256-GCM --> Enc[Encrypted Config]
    Server --> GSC[Google Search Console API]
    Server --> GA4[Google Analytics 4 API]
    Server --> Bing[Bing Webmaster API]
    Server --> Adobe[Adobe Analytics API]

---