Meetup MCP

Purpose

• MCP server for meetup planning using Kakao Local + Kakao Mobility directions.

• Supports driving-time-balanced meetup area suggestions and nearby place recommendations.

Related MCP server: MCP Kakao Local

Key Behaviors

• Uses Kakao REST API key for both Local and Mobility APIs.

• Loads .env explicitly from the project directory via python-dotenv.

• Default transport is stdio; can switch to HTTP with MCP_TRANSPORT=streamable-http.

Tools

• geocode: free-text -> place candidates (lat/lng) via Kakao Local keyword search.

• search_places: search places around an area center (keyword search), supports hotplace flag.

• plan_meetup_driving: main planner; resolves origins, ranks areas by driving time, then recommends places.

Natural Language Handling (in plan_meetup_driving)

• Single-origin text like "인천에서 강남 사이" is split into two origins.

• Vague origins like "내 집/근처/현재 위치" cause NEED_LOCATION response asking for a real place.

• preferences_text auto-parses cuisine preferences (e.g., 고기/일식/카페/술집) and hotplace intent.

• hotplace adds "핫플" to the search keyword.

Preferred Areas

• prefer_areas list: add candidate stations near preferred areas.

• Bonus scoring applied based on distance to preferred areas:

  • <= 3 km: +12

  • <= 8 km: +6

• Response includes prefer_distance_km and prefer_bonus per area.

Cloud Run Compatibility

• FastMCP binds to 0.0.0.0 and PORT (default 8080).

• Dockerfile sets MCP_TRANSPORT=streamable-http and exposes 8080.

• MCP HTTP endpoint for Cloud Run is /mcp.

Files Changed

• meetup-mcp/server.py

• meetup-mcp/dockerfile

• meetup-mcp/requirements.txt

• meetup-mcp/.env.example

• meetup-mcp/.env

Claude Desktop (Windows) MCP Config

• %APPDATA%\Claude\claude_desktop_config.json

• Example: { "mcpServers": { "meetup-mcp": { "command": "C:\Python313\python.exe", "args": [ "C:\Users\CNXK\Desktop\projectfiles\개인\meetup-mcp\server.py" ] } } }

Notes

• Cloud Run is HTTP-only; stdio works for Claude Desktop.

• PlayMCP likely expects HTTP access (not stdio).