Skip to content
Back to search

epicure-mcp

Public read-only MCP server for the Epicure ingredient-embedding model

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kaikaku-ai--epicure-mcp/badge.svg)](/listings/kaikaku-ai--epicure-mcp)

HTML

<a href="/listings/kaikaku-ai--epicure-mcp"><img src="/api/listings/kaikaku-ai--epicure-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 192 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Epicure MCP
  2. [Epicure](https://epicure.kaikaku.ai/agents) is a public, anonymous,
  3. read-only Model Context Protocol server for computational flavour exploration.
  4. It exposes deterministic tools over 1,790 ingredient embeddings learned from a
  5. 4.14 million-recipe, multilingual corpus.
  6. - **MCP endpoint:** `https://epicure-mcp.kaikaku.ai/mcp`
  7. - **Health check:** `https://epicure-mcp.kaikaku.ai/healthz`
  8. - **Interactive guide:** [epicure.kaikaku.ai/agents](https://epicure.kaikaku.ai/agents)
  9. - **Authentication:** none
  10. - **Transport:** Streamable HTTP
  11. The production origin runs on KAIKAKU's local compute cluster and is published
  12. through a Cloudflare Tunnel. It is not hosted on Google Cloud or Azure. Every
  13. tool reads the bundled model artefacts; the MCP server makes no external AI or
  14. data-provider calls.
  15. ## Connect from Cursor
  16. ### Marketplace plugin (recommended)
  17. This repository is packaged as a Cursor Plugin (`.cursor-plugin/plugin.json` +
  18. `mcp.json`). After it is listed, install **Epicure** from
  19. [Cursor Marketplace](https://cursor.com/marketplace) or **Customize → Plugins**.
  20. Until the listing is live, install from this checkout for local testing:
  21. ```bash
  22. mkdir -p ~/.cursor/plugins/local
  23. ln -sfn "$(pwd)" ~/.cursor/plugins/local/epicure
  24. ```
  25. Reload Cursor, enable the plugin, then try:
  26. - “Use Epicure to build a vegan pairing graph around tomato and basil.”
  27. - “Compare miso and soy sauce on the savoury axis.”
  28. - “What ingredients are nearest to saffron in Epicure’s flavour space?”
  29. - “Move rice 30 degrees toward the South Asian cuisine direction.”
  30. - “Show where yuzu sits on Epicure’s ingredient atlas.”
  31. - “Find a flavour trade-off from miso along a coherent factor.”
  32. Submission checklist: [docs/CURSOR_MARKETPLACE_SUBMISSION.md](docs/CURSOR_MARKETPLACE_SUBMISSION.md).
  33. Validate scaffolding with `python scripts/validate_plugin.py`.
  34. ### Manual MCP entry
  35. In Cursor MCP settings, add:
  36. ```json
  37. {
  38. "mcpServers": {
  39. "epicure": {
  40. "type": "http",
  41. "url": "https://epicure-mcp.kaikaku.ai/mcp"
  42. }
  43. }
  44. }
  45. ```
  46. No API key is required for the public endpoint.
  47. ## Connect from Claude
  48. In Claude, open **Settings → Connectors → Add custom connector** and enter:
  49. ```text
  50. Name: Epicure
  51. URL: https://epicure-mcp.kaikaku.ai/mcp
  52. Auth: None
  53. ```
  54. Tool outputs describe learned statistical relationships. They are not food
  55. safety, allergy, medical, or nutritional advice.
  56. ## Tools
  57. All tools advertise read-only, non-destructive, idempotent, closed-world MCP
  58. annotations and validated JSON schemas.
  59. | Tool title | MCP name | Purpose |
  60. | --- | --- | --- |
  61. | Compare ingredients on an axis | `compare_on_axis` | Compare two ingredients along a named flavour, cuisine, nutrient, diet, or processing axis. |
  62. | Score an ingredient pairing | `pairing_score` | Measure cosine affinity for one exact ingredient pair. |
  63. | Explore ingredient pairings | `find_pairings` | Build a diversified cluster-and-bridge pairing graph for one or more seeds. |
  64. | Inspect flavour correlations | `flavour_correlations` | Return the strongest relationships between named flavour-space axes. |
  65. | Profile an ingredient by cuisine | `cultural_profile` | Measure an ingredient against the bundled cuisine directions. |
  66. | Find similar ingredients | `neighbors` | Return nearest ingredients in the 300-dimensional embedding. |
  67. | Transform an ingredient in flavour space | `morph` | Rotate a seed toward a direction, mode, or ingredient using spherical interpolation. |
  68. | List transformation targets | `list_targets` | Page through valid directions and emergent modes for `morph`. |
  69. | List flavour factors | `list_factors` | Inspect the 20 named ICA factor summaries, with examples available on request. |
  70. | Project an ingredient onto a factor | `ingredient_on_factor` | Measure signed position on an ICA factor. |
  71. | Navigate a flavour trade-off | `pareto_navigate` | Find ingredients on a proximity-versus-factor Pareto frontier. |
  72. | Find an ingredient’s flavour region | `closest_mode` | Find the closest named GMM modes. |
  73. | Locate an ingredient on the atlas | `where_on_atlas` | Return the precomputed atlas coordinate and nearby 2-D peers. |
  74. Large catalogues are filtered and paginated. Default responses are deliberately
  75. compact; callers can request more detail through each tool's documented inputs.
  76. ## Data and privacy
  77. Epicure has no accounts, cookies, user profiles, or advertising. Tool arguments
  78. and result content are processed in memory and are never written to application
  79. logs. Minimal operational telemetry contains a rotating pseudonymous client
  80. hash, tool name, response size, latency, success state, and exception class.
  81. Read the complete [Privacy Policy](PRIVACY.md), [Security Policy](SECURITY.md),
  82. [Support Policy](SUPPORT.md), and [Terms](TERMS.md).
  83. ## Architecture
  84. ```text
  85. MCP client
  86. │ HTTPS / Streamable HTTP
  87. ▼
  88. Cloudflare edge (TLS, DDoS controls, WAF/rate limits)
  89. │ outbound-only Cloudflare Tunnel
  90. ▼
  91. reef-cluster on local KAIKAKU compute
  92. └── epicure-mcp container
  93. └── bundled read-only model artefacts
  94. ```
  95. The origin binds to loopback on the cluster host. No inbound router port is
  96. opened; `cloudflared` initiates the tunnel from the private Docker network.
  97. See [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for operations,
  98. [docs/CLAUDE_SUBMISSION.md](docs/CLAUDE_SUBMISSION.md) for the Claude directory
  99. listing, and [docs/CURSOR_MARKETPLACE_SUBMISSION.md](docs/CURSOR_MARKETPLACE_SUBMISSION.md)
  100. for the Cursor Marketplace package.
  101. ## Local development
  102. Python 3.11 or newer is supported (production uses Python 3.12).
  103. ```bash
  104. python3.12 -m venv .venv
  105. source .venv/bin/activate
  106. pip install -e ".[dev]"
  107. python scripts/verify_data.py --data-dir data
  108. ruff check src tests scripts
  109. pytest -q
  110. python -m epicure_mcp.server
  111. ```
  112. The local endpoints are:
  113. | Path | Method | Purpose |
  114. | --- | --- | --- |
  115. | `/healthz` | GET | Lightweight liveness probe. |
  116. | `/mcp` | POST/GET/DELETE | Streamable HTTP MCP transport. |
  117. | `/atlas` | GET | Read-only 3-D UMAP projection used by the Epicure site. |
  118. | `/favicon.ico`, `/favicon.png` | GET | Connector icon. |
  119. Inspect the local server with the official MCP Inspector:
  120. ```bash
  121. npx -y @modelcontextprotocol/inspector \
  122. --cli http://127.0.0.1:8080/mcp --transport http --method tools/list
  123. ```
  124. Run the complete remote smoke suite against production:
  125. ```bash
  126. python scripts/smoke_test_remote.py https://epicure-mcp.kaikaku.ai/mcp
  127. ```
  128. ## Configuration
  129. | Variable | Default | Purpose |
  130. | --- | --- | --- |
  131. | `EPICURE_DATA_DIR` | `<repo>/data` | Bundled artefact directory. |
  132. | `EPICURE_ASSETS_DIR` | bundled assets | Optional favicon directory. |
  133. | `HOST` | `0.0.0.0` | Bind address. |
  134. | `PORT` | `8080` | Bind port. |
  135. | `RATE_LIMIT_PER_MINUTE` | `60` | Per-client token refill rate. |
  136. | `RATE_LIMIT_BURST` | `10` | Per-client burst capacity. |
  137. | `MCP_SERVER_NAME` | `Epicure` | Name in the MCP initialize response. |
  138. | `MCP_AUTH_MODE` | `none` | Authentication mode: anonymous `none`, or explicit `bearer` for a private deployment. |
  139. | `MCP_API_TOKEN` | unset | Bearer credential required when `MCP_AUTH_MODE=bearer`. For backward compatibility, a token with no mode retains legacy bearer auth; public deployments must pin `MCP_AUTH_MODE=none`. |
  140. | `MCP_ALLOWED_HOSTS` | production + local hosts | Comma-separated DNS-rebinding allowlist. |
  141. | `MCP_ALLOWED_ORIGINS` | ChatGPT, Claude, Cursor, Epicure + local origins | Comma-separated browser-origin allowlist. |
  142. ## Bundled artefacts
  143. The repository includes the model bundle, so production does not depend on an
  144. upstream service at runtime. It contains embeddings and ingredient metadata,
  145. supervised directions, ICA factors, GMM modes, and 2-D/3-D UMAP projections.
  146. Validate shape and presence with `scripts/verify_data.py` after any refresh.
  147. ## License
  148. [MIT](LICENSE) © KAIKAKU.AI Limited.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.