Skip to main content
Glama
stmtc233

gaokao-helper-worker-mcp

by stmtc233

Gaokao Helper MCP for Cloudflare Workers

A standalone Cloudflare Worker that exposes public Guangdong gaokao data through a read-only MCP endpoint.

Deploy to Cloudflare

The deployment button creates a copy of this repository in your GitHub account, provisions a Worker, and configures Workers Builds for subsequent pushes.

Endpoints

  • GET /health returns a small health payload.

  • POST /mcp is the streamable HTTP MCP endpoint.

  • Static data files are deployed from the committed public/ snapshot, so this repository builds independently.

Related MCP server: NanoSearchMCP

Tools

  • list_data_files lists available data files and resource URIs.

  • read_data_sample reads a bounded sample from a CSV or JSON file.

  • search_schools searches across school, group, major, code, and other CSV text.

  • score_rank_lookup looks up the nearest row in score_rank_2026.csv.

Commands

npm ci
npm run dev

Deploy:

npm run deploy

After deployment, connect MCP clients to:

https://<your-worker-host>/mcp

Updating the data snapshot

When the source gaokao-helper checkout is the parent directory:

npm run sync:data

For a source checkout elsewhere, pass its path explicitly:

GAOKAO_HELPER_ROOT=/path/to/gaokao-helper npm run sync:data

Commit the updated files under public/ so Cloudflare's one-click deployment remains self-contained.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides web search, page fetching, and A-stock data access (financial reports, announcements, research reports, penalties, IR meetings) via MCP tools.
    -
  • A
    license
    A
    quality
    D
    maintenance
    Provides access to Chinese A-share market financial data, including historical K-line, real-time quotes, financial statements, shareholder information, and technical indicators, via MCP protocol.
    12
    32 npm
    3
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides read-only access to Google Ads account data including campaigns, ad groups, keywords, and performance reports. Enables querying via GAQL through an MCP interface.
    MIT