Timing Jeju FastAPI MCP
Internal MCP server for itinerary calculation and AI functions, receiving structured facts from a Spring backend via stateless MCP Streamable HTTP.
README
Timing Jeju FastAPI MCP
Timing Jeju의 일정 계산과 AI 기능을 담당하는 내부 FastAPI MCP 저장소입니다. Python 버전, 의존성 잠금과 품질 도구만 제공하며 애플리케이션 패키지 구조는 아직 정하지 않습니다.
공개 REST API, 사용자 인증, DB·외부 API 연동과 계산 결과 저장은 별도 Timing-Jeju/jeju_BE Spring 백엔드가 담당합니다. 이 서비스는 Spring이 private network로 전달한 구조화 facts만 계산합니다.
준비된 최소 환경
- Python 3.12
- uv 기반 의존성 및
uv.lock - FastAPI와 MCP Python SDK 안정 버전 1.x
- Ruff 린트·포맷, mypy 엄격 타입 검사, pytest
- develop/main 대상 독립 GitHub Actions CI
- 운영 Python 파일이 생기면 대응 테스트를 요구하는 품질 게이트
uv sync --locked --group dev
./scripts/quality-gate.sh
uv가 없다면 uv 공식 설치 안내에 따라 먼저 설치합니다.
개발자가 결정할 내용
첫 FastAPI 기능 Issue에서 서비스 특성과 팀 합의에 따라 패키지 루트, 모듈 분리, 테스트 디렉터리와 실행 엔트리포인트를 결정합니다. app/, src/, 도메인·계층 디렉터리 중 어느 것도 현재 설정이 강제하지 않습니다.
실행 엔트리포인트가 정해진 뒤 Dockerfile, Health Check와 커버리지 대상을 추가합니다. 구조를 정하기 전에는 빈 엔드포인트나 예시 MCP Tool을 만들지 않습니다.
책임
- Spring API가 전달한 구조화 facts 기반 일정 생성·검증·위험도 계산
- Stateless MCP Streamable HTTP
POST /mcp - 내부용
/health/live,/health/ready - 결과의
contractVersion,inputHash, reason code 유지
금지 사항
- DB 직접 접근
- 외부 관광·교통·날씨·지도 API 직접 호출
- 입력에 없는 ID 생성
- 사용자 JWT와 개인정보 수신
- 활성 일정 직접 변경
계약 문서
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.
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.
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.
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.