today-top3-mcp
A situational local recommendation MCP server that classifies user mood, energy, time, and budget to generate three actionable choices with search keywords and disclosure policy.
README
오늘 뭐하지 3선 MCP
음식·여행·숙박·휴식·액티비티를 3개 선택지로 줄여주는 상황형 로컬 추천 MCP 서버입니다.
사용자가 “오늘 뭐하지?”, “배고픈데 나가기 귀찮아”, “기분이 별로인데 집에만 있긴 싫어”처럼 애매하게 말하면 현재 문장에서 드러나는 기분, 피로도, 시간 여유, 이동 가능성, 예산을 분류하고 지금 실행 가능한 선택지 3개를 반환합니다.
핵심 기능
- 현재 상황 분류: 기분, 에너지, 욕구, 이동 가능성, 예산, 시간 여유
- 선택지 3개 생성: 음식, 여행/산책, 숙박, 휴식, 액티비티
- 선택지별 검색 키워드 생성
- 광고·제휴·결제 가능 정보 분리 정책 제공
MCP Tools
| Tool | 설명 |
|---|---|
classify_today_context |
사용자 문장에서 상황 태그를 분류합니다. |
generate_top3_choices |
상황에 맞는 실행 가능한 선택지 3개를 생성합니다. |
build_search_keywords |
선택지 ID와 위치 텍스트를 검색 키워드 3개로 변환합니다. |
apply_disclosure_policy |
광고·제휴·결제 가능 정보 분리 정책을 반환합니다. |
HTTP Endpoints
| Endpoint | 설명 |
|---|---|
GET /health |
서버 상태 확인 |
POST /mcp |
Streamable HTTP MCP endpoint |
GET /mcp |
Streamable HTTP MCP session endpoint |
DELETE /mcp |
Streamable HTTP MCP session 종료 |
로컬 실행
npm install
npm run dev
상태 확인:
curl http://localhost:3000/health
Docker 실행
docker build -t today-top3-mcp .
docker run -p 3000:3000 today-top3-mcp
개인정보·광고 정책
이 서버는 로그인, 위치 권한, 결제 정보, 사용자 프로필을 사용하지 않습니다. 입력된 문장과 선택적 위치 텍스트만 현재 요청 처리에 사용합니다.
광고·제휴·결제 가능 정보는 일반 추천과 분리해 표시하도록 설계했습니다. 감정 저하 또는 피로 상태에서는 고가·충동구매성 추천을 제한합니다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.