Shopee Log MCP Server

TypeScript MCP server for Codex that runs Shopee log queries through the log platform's Mgmt API and Querymaster WebSocket flow.

Status

This repository includes:

• A working MCP stdio server with a query_logs tool.

• Config-driven service and environment resolution.

• Session reuse from environment variables or a JSON session file.

• HTTP and WebSocket client implementations with typed orchestration.

• Protocol-capture templates so real browser-captured contracts can be dropped in without reshaping the code.

• Unit and fixture-backed integration tests.

This repository does not include real Shopee endpoint values or session secrets. Those must be provided through configuration after protocol capture.

Related MCP server: MCP Docs RAG Server

Configuration

Set SHOPEE_LOG_MCP_CONFIG to a JSON file path or inline JSON string matching config/log-mcp.example.json.

Session data can be supplied either by:

• SHOPEE_LOG_SESSION_FILE: path to a JSON file containing cookieHeader and optional csrfToken, or

• SHOPEE_LOG_COOKIE_HEADER plus optional SHOPEE_LOG_CSRF_TOKEN

Scripts

• npm run build

• npm test

• npm run start

Protocol Capture

Use docs/PROTOCOL_CAPTURE.md to capture the real Mgmt API and Querymaster contract from browser traffic before pointing this server at production systems.