Locations MCP Server

This project implements a Model Context Protocol (MCP) server with tools for WordPress content extraction, keyword research, and optimized content generation.

Project Structure

• api/ – Vercel serverless entry point.

• src/clients/ – External API clients (WordPress, Google keyword suggestions, Google Trends).

• src/services/ – Shared services such as caching, logging, and content processing.

• src/tools/ – MCP tool handlers.

• src/types/ – Shared interfaces and types.

Setup

1. Install dependencies:

   npm install

2. Copy environment defaults:

   cp .env.example .env

3. Build the project:

   npm run build

Tools

• extract_wordpress_content – Fetches pages/posts from a WordPress site with pagination, sanitization, and caching.

• research_keywords – Generates keyword ideas using Google autocomplete and Trends data with intent classification.

• generate_optimized_content – Builds structured content using simple Indian English and reports quality metrics.

Deployment

The api/mcp.ts entry is compatible with Vercel serverless functions. The build outputs to dist/ and the start script runs the compiled handler locally.