This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
This is a Google Trends MCP (Model Context Protocol) server that provides access to Google Trends data through the RapidAPI Google Trends Scraper API. The server implements three main endpoints:
# Install dependencies npm install # Build TypeScript npm run build # Run in development mode with auto-reload npm run dev # Run the compiled server npm start
# Run all tests npm test # Run specific test suites npm run test:unit # Unit tests only npm run test:integration # Integration tests only npm run test:watch # Watch mode # Run tests with coverage npm test -- --coverage # Run a single test file npm test -- tests/integration/search.test.ts # Run tests matching a pattern npm test -- --testNamePattern="should search for" # Run tests with single worker (useful for debugging) npm test -- --maxWorkers=1
The server is built using the Model Context Protocol SDK and follows this pattern:
Main Server Class (
src/index.tsGoogleTrendsMcpServerStdioServerTransportListToolsRequestSchemaCallToolRequestSchemaAPI Integration Pattern:
makeApiRequest()Type System (
src/types.tsStatusParamsQuestionsParamsTrendingParamsTests use a parallel structure that mirrors the production code:
Test Client (
tests/helpers/test-server.tsGoogleTrendsTestClientIntegration Tests: Each endpoint has comprehensive tests covering:
Simple API Integration: Direct API calls to Google Trends endpoints
/status/questions/trendingError Handling: Two-layer approach:
Environment Configuration:
GOOGLE_TRENDS_API_KEYThe Google Trends API returns data in these formats:
To test the server with MCP protocol:
# Build first npm run build # Or run directly npm start # For development with auto-reload npm run dev
The server communicates via stdio and implements the standard MCP protocol for tool discovery and execution.