Skip to main content
Glama
nefisyemektarifleri-mcp

nefisyemektarifleri-mcp

nefisyemektarifleri-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/nefisyemektarifleri-mcp

Unofficial read-only MCP server for Nefis Yemek Tarifleri (nefisyemektarifleri.com) — Türkiye's biggest recipe site: search 14,000+ recipes per query, full recipe details (ingredients with amounts, steps, tips, times, servings, ratings, nutrition), the full recipe-category tree, category listings with popular/trending/newest sorts, the most-made recipes and the daily "Bugün Ne Pişirsem?" menu.

Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Nefis Yemek Tarifleri.

For AI agents

Add to your MCP client config (stdio):

{
  "mcpServers": {
    "nefis": {
      "command": "uvx",
      "args": ["nefisyemektarifleri-mcp==0.1.0"]
    }
  }
}

Or run locally: python -m nefisyemektarifleri_mcp.server (needs mcp<2, curl-cffi, requests).

Related MCP server: armut-mcp

Tools

Tool

Description

nefis_search_recipes

Search recipes by dish/ingredient — query, limit (1..30), page (1..20)

nefis_get_recipe

Full recipe — full URL or bare slug (e.g. mercimek-corbasi-tarifi)

nefis_list_categories

Full category tree (24 top-level, 74 subcategories)

nefis_category_recipes

Recipes in one category — category slug/URL, limit, page, sort (popular/trending/newest)

nefis_trending

Most-made recipes ("En Çok Yapılanlar", 24)

nefis_daily_menu

Today's "Bugün Ne Pişirsem?" menu (25 recipes)

nefis_health

Reachability check (ok / blocked / error)

Example output (nefis_search_recipes / "mercimek"):

{"query": "mercimek", "total_results": 14694,
 "recipes": [{"title": "Mercimek Köftesi Nasıl Yapılır? (videolu)",
   "serves": "4-6", "prep_time": "50dk", "cook_time": "30dk",
   "author": "Elif Atalar", "saved_count": 385000, "comment_count": 2985}]}

Example output (nefis_get_recipe / "mercimek-corbasi-tarifi"):

{"title": "Mercimek Çorbası Tarifi", "rating": 4.8, "rating_votes": 388,
 "serves": "6-8", "prep_time": "15dk", "cook_time": "30dk",
 "ingredients": [{"group": "Malzemeler",
   "items": ["2 su bardağı kırmızı mercimek", "1 adet soğan", "..."]},
  {"group": "Sosu için:",
   "items": ["2 yemek kaşığı tereyağı", "..."]}],
 "steps": ["Kırmızı mercimek çorbası için sıvı yağı ...", "..."],
 "nutrition_per_serving": {"calories_kcal": 284, "carbs_g": 25,
   "protein_g": 13, "fat_g": 12.5, "fiber_g": 5.05}}

Notes:

  • Search is the site's own /ara/ page — Cloudflare rejects requests without a Referer, so every request sends the site as Referer; transport uses Chrome TLS impersonation with a plain-requests fallback.

  • Listings paginate WordPress-style (/page/2/); ?sayfa=N is ignored by the site (it silently returns page 1), so the server never uses it.

  • Times are Turkish shorthand (15dk); servings are Turkish (6-8 kiÅŸilik); saved/comment counts parse Turkish abbreviations (385bin → 385000).

  • Data: nefisyemektarifleri.com public pages — no key, no login, read-only.

Development

python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi requests pytest
.venv/bin/python -m pytest tests/ -q
  • tests/test_recipes.py — offline, parses real captured fixtures

  • tests/test_live.py — 9 cautious live requests against nefisyemektarifleri.com

License

MIT


Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Available Tools

7 tools
nefis_category_recipesA

Recipes in one category. category: a slug from nefis_list_categories (e.g. "corba-tarifleri") or a full category URL. limit 1..30. page 1..20. sort: "popular" (default), "trending" or "newest".

Inputs: category (required), page, sort, limit. Returns: result

nefis_daily_menuA

Today's "Bugün Ne Pişirsem?" menu — 25 recipes picked for today. limit 1..25.

Inputs: limit. Returns: result

nefis_get_recipeB

Full recipe detail: ingredients with amounts, steps, tips, times, servings, rating, nutrition, author. url: a full nefisyemektarifleri.com recipe URL (e.g. https://www.nefisyemektarifleri.com/mercimek-corbasi-tarifi/) or a bare slug/path like "mercimek-corbasi-tarifi".

Inputs: url (required). Returns: result

nefis_healthA

Check whether nefisyemektarifleri.com is reachable right now.

Returns status ok (HTTP 200), blocked (HTTP 403/429 — bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings.

Inputs: no named parameters. Returns: result

nefis_list_categoriesA

The full recipe-category tree from nefisyemektarifleri.com (top-level categories with their subcategories: name, slug, url). Use a slug from here with nefis_category_recipes.

Inputs: no named parameters. Returns: result

nefis_search_recipesA

Search Nefis Yemek Tarifleri recipes by dish or ingredient. query: e.g. "mercimek", "tavuk", "sütlü tatlı". limit 1..30 (13 per page — the server fetches further pages as needed). page 1..20. Returns matching recipes (title, url, serves, prep/cook times, author, saved/comment counts, video flag, image) + total results.

Inputs: query (required), page, limit. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct retrieval mode: curated trending list, free-text search, single-recipe detail, category tree, recipes within a category, today's editorial menu, and a reachability probe. The only superficially similar pair (trending vs. daily menu) is clearly separated by 'most-made all-time' versus 'picked for today'. Descriptions explicitly cross-reference each other (list_categories → category_recipes), removing boundary confusion.

    Naming Consistency4/5

    All names share a consistent 'nefis_' prefix and snake_case, which makes the set predictable and easy to scan. However the verb style is mixed: some are verb_noun (search_recipes, get_recipe, list_categories) while others are bare noun/adjective phrases (trending, daily_menu, health).

    Tool Count5/5

    Seven tools is well within the ideal range and each one maps to a real browsing need (discover, search, drill down, check status). No tool feels redundant or vestigial for a recipe-site reader.

    Completeness4/5

    The discovery-and-read lifecycle is well covered: browse by category, search, open a full recipe with ingredients and steps, plus trending and daily menu entry points. Minor gaps exist for a read-only recipe surface — no author lookup, no 'similar/related recipes', and no way to fetch comments or ratings beyond what get_recipe inlines.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search New York Times Cooking recipes, fetch full recipes with ingredients and steps without login, and browse personal saved recipe box with optional authentication.
      6
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only search and browsing of Türkiye's local-services marketplace: keyword search across thousands of services, service details, top-rated professionals filtered by city, FAQs, 12-month price guides with real quote examples, and trending services. No API key or login required.
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only search and browsing of n11.com products, including product details, customer reviews, top categories, and price statistics. It provides AI agents with structured marketplace data such as prices, stock status, ratings, sellers, and category paths.
      5
      MIT