Epicure MCP

Epicure는 계산적 풍미 탐색을 위한 공개적이고 익명이며 읽기 전용인 Model Context Protocol 서버입니다. 414만 개 레시피의 다국어 말뭉치에서 학습된 1,790개의 재료 임베딩에 대해 결정론적 도구를 제공합니다.

• MCP 엔드포인트: https://epicure-mcp.kaikaku.ai/mcp

• 헬스 체크: https://epicure-mcp.kaikaku.ai/healthz

• 대화형 가이드: epicure.kaikaku.ai/agents

• 인증: 없음

• 전송 방식: Streamable HTTP

프로덕션 오리진은 KAIKAKU의 로컬 컴퓨팅 클러스터에서 실행되며 Cloudflare Tunnel을 통해 게시됩니다. Google Cloud나 Azure에는 호스팅되지 않습니다. 모든 도구는 번들된 모델 아티팩트를 읽습니다. MCP 서버는 외부 AI 또는 데이터 제공자 호출을 수행하지 않습니다.

Cursor에서 연결

마켓플레이스 플러그인(권장)

이 저장소는 Cursor Plugin(.cursor-plugin/plugin.json + mcp.json)으로 패키징되어 있습니다. 등록된 후에는 Cursor Marketplace 또는 Customize → Plugins에서 Epicure를 설치하세요.

목록에 등록되기 전까지는 로컬 테스트를 위해 이 체크아웃에서 설치하세요:

mkdir -p ~/.cursor/plugins/local
ln -sfn "$(pwd)" ~/.cursor/plugins/local/epicure

Cursor를 다시 로드하고 플러그인을 활성화한 후 다음을 시도해 보세요:

• "Epicure를 사용해 토마토와 바질을 중심으로 비건 페어링 그래프를 구축해 줘."

• "감칠맛 축에서 미소와 간장을 비교해 줘."

• "Epicure의 풍미 공간에서 사프란에 가장 가까운 재료는 무엇인가요?"

• "쌀을 남아시아 요리 방향으로 30도 회전시켜 줘."

• "Epicure의 재료 아틀라스에서 유자를 어디에 배치할 수 있나요?"

• "미소에서 일관된 요인을 따라 풍미 트레이드오프를 찾아 줘."

제출 체크리스트: docs/CURSOR_MARKETPLACE_SUBMISSION.md. python scripts/validate_plugin.py로 스캐폴딩을 검증하세요.

수동 MCP 항목

Cursor MCP 설정에서 다음을 추가하세요:

{
  "mcpServers": {
    "epicure": {
      "type": "http",
      "url": "https://epicure-mcp.kaikaku.ai/mcp"
    }
  }
}

공개 엔드포인트에는 API 키가 필요하지 않습니다.

Related MCP server: taste-mcp

Claude에서 연결

Claude에서 Settings → Connectors → Add custom connector를 열고 다음을 입력하세요:

Name: Epicure
URL:  https://epicure-mcp.kaikaku.ai/mcp
Auth: None

도구 출력은 학습된 통계적 관계를 설명합니다. 식품 안전, 알레르기, 의학 또는 영양 관련 조언이 아닙니다.

도구

모든 도구는 읽기 전용, 비파괴적, 멱등적, 폐쇄 세계 MCP 주석과 검증된 JSON 스키마를 광고합니다.

대규모 카탈로그는 필터링되고 페이지 단위로 제공됩니다. 기본 응답은 의도적으로 간결합니다. 호출자는 각 도구의 문서화된 입력을 통해 더 많은 세부 정보를 요청할 수 있습니다.

데이터 및 개인정보 보호

Epicure에는 계정, 쿠키, 사용자 프로필 또는 광고가 없습니다. 도구 인수와 결과 콘텐츠는 메모리에서 처리되며 애플리케이션 로그에 기록되지 않습니다. 최소한의 운영 텔레메트리에는 순환하는 가명 클라이언트 해시, 도구 이름, 응답 크기, 지연 시간, 성공 상태 및 예외 클래스가 포함됩니다.

전체 개인정보 보호정책, 보안 정책, 지원 정책 및 이용약관을 읽어보세요.

아키텍처

MCP client
    │  HTTPS / Streamable HTTP
    ▼
Cloudflare edge (TLS, DDoS controls, WAF/rate limits)
    │  outbound-only Cloudflare Tunnel
    ▼
reef-cluster on local KAIKAKU compute
    └── epicure-mcp container
          └── bundled read-only model artefacts

오리진은 클러스터 호스트의 루프백에 바인딩됩니다. 인바운드 라우터 포트는 열리지 않습니다. cloudflared가 프라이빗 Docker 네트워크에서 터널을 시작합니다. 운영에 대해서는 docs/DEPLOYMENT.md, Claude 디렉터리 목록에 대해서는 docs/CLAUDE_SUBMISSION.md, Cursor Marketplace 패키지에 대해서는 docs/CURSOR_MARKETPLACE_SUBMISSION.md를 참조하세요.

로컬 개발

Python 3.11 이상이 지원됩니다(프로덕션은 Python 3.12 사용).

python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
python scripts/verify_data.py --data-dir data
ruff check src tests scripts
pytest -q
python -m epicure_mcp.server

로컬 엔드포인트는 다음과 같습니다:

공식 MCP Inspector로 로컬 서버를 검사하세요:

npx -y @modelcontextprotocol/inspector \
  --cli http://127.0.0.1:8080/mcp --transport http --method tools/list

프로덕션에 대해 전체 원격 스모크 테스트 스위트를 실행하세요:

python scripts/smoke_test_remote.py https://epicure-mcp.kaikaku.ai/mcp

구성

번들된 아티팩트

저장소에는 모델 번들이 포함되어 있어 프로덕션이 런타임에 업스트림 서비스에 의존하지 않습니다. 임베딩과 재료 메타데이터, 지도 학습 방향, ICA 요인, GMM 모드, 2차원/3차원 UMAP 투영이 포함되어 있습니다. 새로 고침 후 scripts/verify_data.py로 형태와 존재 여부를 검증하세요.

라이선스

MIT © KAIKAKU.AI Limited.