Skip to main content
Glama
nefisyemektarifleri-mcp

nefisyemektarifleri-mcp

README.md
# 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):

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

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

## 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"):

```json
{"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"):

```json
{"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

```bash
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](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

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