Repository avatar
Monitoring
v0.5.0
active

gaja-mcp

io.github.rlrdus-qq/gaja-mcp

Real-world measured visit big data and travel course recommendation MCP for South Korea.

Documentation

GAJA (κ°€μž) - Korea Travel & Measured Visits MCP Server

MCP Registry License: MIT Status: Live

GAJA is a production remote Model Context Protocol (MCP) server providing verified travel destinations and optimized itineraries across 250+ administrative districts in South Korea, powered by real-world telecommunication and navigation visit big data.


🌟 Key Features

  • Real-World Measured Big Data: Uses actual mobile carrier roaming and navigation movement volumes from the Korea Tourism Organization (TourAPI) and TMAP Big Data, eliminating hallucinations.
  • Full Regional Coverage: 250+ cities, counties, and districts across South Korea (Seoul, Gangwon, Jeju, Busan, Inje, etc.).
  • Multi-day Course Generator: Automatically generates 1-day to 8-day structured itineraries with morning/lunch/afternoon/dinner/lodging schedules and live weather forecasts.
  • Foreign Visitor Surge Detection: Identifies rapidly emerging travel spots popular among inbound foreign tourists by nationality.
  • Production-Ready & High Performance: Deployed over HTTP with Streamable-HTTP (stateless_http=True), payload optimized under 16KB for compatibility with all MCP clients.

πŸ“‘ Live Remote MCP Endpoints

ResourceURLDescription
MCP Live Endpointhttps://gaja.mocean.kr/mcpStreamable-HTTP / JSON-RPC Transport
RFC Standard Discoveryhttps://gaja.mocean.kr/.well-known/mcp.jsonDiscovery manifest
Server Metadatahttps://gaja.mocean.kr/.well-known/mcp-server.jsonSchema & version descriptor
AI Context Indexhttps://gaja.mocean.kr/llms.txtContext for LLMs & AI search engines

πŸ› οΈ Provided Tools

1. gaja_recommend_trending_places

  • Description: Recommends top trending travel destinations in South Korea based on statistically verified mobile visit counts.
  • Parameters:
    • limit (integer, optional): Maximum number of destinations to return (default: 5, max: 20).
    • category (string, optional): Travel category filter (nature, culture, leisure, food).

2. gaja_recommend_places

  • Description: Generates an optimized, day-by-day travel itinerary with verified attractions, restaurants, and lodgings for any Korean district.
  • Parameters:
    • query (string, required): Destination name (e.g. 인제ꡰ, κ°•λ¦‰μ‹œ, μ œμ£Όλ„, Inje, Gangneung).
    • days (integer, optional): Duration in days (1 to 8, default: 2).
    • companion (string, optional): Travel companion type (solo, couple, family, friends).

3. gaja_get_foreign_surge

  • Description: Analyzes regional districts experiencing a rapid surge in inbound foreign visitors compared to the previous period.
  • Parameters:
    • top_n (integer, optional): Number of surging districts to return (default: 5).
    • nationality (string, optional): Filter by visitor nationality (e.g., ALL, JP, CN, US).

4. gaja_get_data_freshness

  • Description: Returns the statistical baseline date, aggregation window, data provider provenance, and sample size of the underlying datasets.

πŸš€ Client Configuration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gaja": {
      "url": "https://gaja.mocean.kr/mcp"
    }
  }
}

Note: For Claude Desktop versions supporting remote HTTP MCP, simply add the URL above.

Cursor / Windsurf

Add a new MCP server in settings:

  • Type: command (with mcp-proxy) or direct streamable-http / sse
  • URL: https://gaja.mocean.kr/mcp

Kakao PlayMCP

GAJA is registered on Kakao PlayMCP (gaja identifier) with zero-authentication remote access:

  • Endpoint: https://gaja.mocean.kr/mcp

πŸ“Š Data Reliability & Provenance

Every recommendation returned by GAJA includes a PROVENANCE verification tag linking back to official government and telecom datasets:

  • Korea Tourism Organization TourAPI 4.0
  • TMAP Big Data Navigation Destination Index
  • Korea Meteorological Administration Realtime Forecast

πŸ“„ License

This MCP server metadata and client integration specifications are licensed under the MIT License. Data sources comply with public data licenses (KOGL Type 1).

No installation packages available.

Remote