Skip to main content
MODEL CONTEXT PROTOCOL • MCP v2 dietspremium-mcp v0.0.20 AGENSI • Verified Creator
REST API v1 →

Natywny Serwer MCP dla Autonomicznych Agentów AI

Udostępnij swojemu asystentowi AI bezpośredni dostęp do 12 narzędzi wyszukiwania klinicznego oraz 9 narzędzi tworzenia diet, przepisów i planów treningowych.

Endpoint Serwera MCP https://www.dietspremium.com/_mcp
Oficjalny Klient NPM npx -y dietspremium-mcp
Narzędzia AI 12 Search + 13 Management
02 • Krok 2 • Konfiguracja JSON

Konfiguracja klienta MCP (mcp_config.json)

stdio + HTTP
mcp_config.json / terminal
JSON-RPC 2.0 CONNECTED
npx -y dietspremium-mcp
{
  "mcpServers": {
    "dietspremium": {
      "command": "npx",
      "args": ["-y", "dietspremium-mcp"],
      "env": {
        "DIETSPREMIUM_API_KEY": "YOUR_MCP_KEY"
      }
    }
  }
}
01 • Krok 1 • Architektura

Podłącz serwer MCP w 3 krokach

JSON-RPC 2.0

Natywna obsługa Claude Desktop, Cursor, Windsurf, Gemini CLI, OpenAI Agents oraz LM Studio.

01

1. Dodaj wpis do mcp_config.json

Użyj oficjalnego pakietu npx -y @dietspremium/mcp-server lub bezpośredniego adresu URL /_mcp.

02

2. Autoryzuj klucz X-API-KEY

Narzędzia wyszukiwania działają publicznie; klucz X-API-KEY odblokowuje zapis i edycję encji.

03

3. Twórz i analizuj diety z AI

Agent AI automatycznie wyszuka składniki, przeliczy mikroelementy i zapisze kompletny plan w bazie.

Parametr Środowiska Wartość / Format Opis Techniczny
DIETSPREMIUM_API_KEY Bearer Token (opcjonalny dla Free Tier) Klucz autoryzacyjny dla narzędzi management_* oraz wyższych limitów zapytań.
command / args npx -y dietspremium-mcp Oficjalny mostek stdio kompatybilny z Node.js 18+ i każdym klientem MCP.
Streamable HTTP URL https://www.dietspremium.com/_mcp Bezpośredni punkt końcowy JSON-RPC 2.0 (initialize, tools/list, tools/call).
Zadania inicjalizacyjne klienta MCP (dietspremium-mcp) MCP Handshake

Automatyczny przebieg połączenia ze środowiskiem AI

1
Uruchomienie mostka stdio lub Streamable HTTP npx -y dietspremium-mcp

Klient pobiera oficjalną paczkę NPM i zestawia sesję TLS z https://www.dietspremium.com/_mcp.

DIETSPREMIUM_API_KEY=dp_mcp_xxx npx -y dietspremium-mcp
2
Rejestracja narzędzi w modelu LLM (tools/list) JSON Schema

Agent otrzymuje pełne definicje typów, filtrów makro, jednostek klinicznych oraz walut.

3
Bezpieczne operacje zapisu przez McpKeyCodec (key) Base64 Key

Narzędzia management_* przyjmują zakodowany klucz "key" zwrócony przez narzędzia search_*.

03 • Krok 3 • Katalog 21 Narzędzi 12 Search + 13 Management

Narzędzia Wyszukiwania Semantycznego i Katalogowego (12 Search Tools)

Narzędzia tylko do odczytu (/_mcp/search/*) obsługujące zapytania wektorowe 512d oraz filtry kliniczne.

search_allergen 512d k-NN

Allergen Risk & Intolerance Registry

Dietary allergens, cross-contamination risks, EU 1169/2011 allergen standards, and ingredient intolerance profiles.

Argumenty wejściowe (5):
query* locale page max_results ai
/_mcp/search/allergen Specyfikacja
search_article 512d k-NN

Clinical Nutrition Guides & RAG Grounding

Search 6,000+ peer-reviewed nutrition articles, clinical guidelines, and wellness guides for agent grounding and citations.

Argumenty wejściowe (5):
query* locale page max_results ai
/_mcp/search/article Specyfikacja
search_company 512d k-NN

Dietetic Catering & Clinic Directory

Search 173,000+ health clinics, dietetic catering providers, gyms, and wellness brands with geo-location metadata.

Argumenty wejściowe (5):
query* city locale page max_results
/_mcp/search/company Specyfikacja
search_exercise 512d k-NN

Exercise Biomechanics & Calorie Burn

Search 2,000+ workout exercises with targeted anatomical muscle groups, required equipment, and execution guidelines.

Argumenty wejściowe (5):
query* locale page max_results ai
/_mcp/search/exercise Specyfikacja
search_food 512d k-NN

Nutritional Database & Macro Search

Search 1,900+ verified foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.

Argumenty wejściowe (8):
query* locale proteins_min / proteins_max kcal_min / kcal_max allergen_exclude +3
/_mcp/search/food Specyfikacja
search_medication 512d k-NN

Pharmacology & Food-Drug Interactions

Database of 53,000+ active substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.

Argumenty wejściowe (4):
query* locale page max_results
/_mcp/search/medication Specyfikacja
search_recipe 512d k-NN

Culinary Recipes & Macro Balancing

Search 780+ chef-curated recipes with preparation steps, ingredients with gram weights, portion macronutrients, and difficulty levels.

Argumenty wejściowe (5):
query* locale page max_results ai
/_mcp/search/recipe Specyfikacja
search_user 512d k-NN

Specialists & Certified Dietitians

Search verified clinical dietitians, sports nutritionists, and certified personal trainers for client assignment.

Argumenty wejściowe (4):
query* locale page max_results
/_mcp/search/user Specyfikacja
search_supplement 512d k-NN

Supplements & Active Dosages

Dietary supplements catalog with active compound dosages, vitamin forms, and safety guidance.

Argumenty wejściowe (4):
query* locale page max_results
/_mcp/search/supplement Specyfikacja
search_diet 512d k-NN

Clinical & Lifestyle Diet Templates (158 Types)

Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.

Argumenty wejściowe (9):
query diet_template_type days avoid_allergens kcal_min / kcal_max +4
/_mcp/search/diet Specyfikacja
search_food_world 512d k-NN

Global Food Products & Barcodes (Open Food Facts + USDA)

Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.

Argumenty wejściowe (7):
query barcode brand locale currency +2
/_mcp/search/food-world Specyfikacja
search_knowledge 512d k-NN

Clinical Knowledge & Dietetic Grounding

Clinical nutrition guidelines, scientific dietary facts, medical definitions, and evidence-based grounding.

Argumenty wejściowe (4):
query* locale page max_results
/_mcp/search/knowledge Specyfikacja

Narzędzia Zarządzania i Tworzenia Encji (Management Tools) (/_mcp/management/*)

9 NARZĘDZI ZAPISU • X-API-KEY
management_account CRUD • Base64 key

Account, Profile, GeoName Address (Residential, Delivery, Work), Job, Education & S3 Avatar/Cover

Manage your personal profile (first/last name), S3 avatar & background cover images, verified GeoName residential/delivery/work addresses with street mapping, jobs, educations, and personal tags.

/_mcp/management/account Dokumentacja
management_calendar CRUD • Base64 key

Personal & Company Calendar Events Manager

List, create, edit, and delete events in your personal or company calendar with public/private visibility and S3 media attachments.

/_mcp/management/calendar Dokumentacja
management_company CRUD • Base64 key

Company, Clinic & Catering Profile Management

Manage owned or assigned companies (CompanyTrainerAssign allow_edit=1): address, Mon-Sun opening hours, website, features, and S3 media.

/_mcp/management/company Dokumentacja
management_patient CRUD • Base64 key

Patient & Client CRM (List, Add, Edit, Soft-Deactivate)

List your patients, onboard new patients, update patient profiles and clinical notes, or deactivate patient assignments (active = 0).

/_mcp/management/patient Dokumentacja
management_diet CRUD • Base64 key

Diet Builder (Trainer Mode) & Patient Tracking / Fridge Replacement AI

Dual-mode diet management: Trainer Mode (granted_to=NULL) for full diet/day/meal/recipe/food/supplement/exercise editing, and Patient Mode (granted_to=user) for water/feel/notes logging and AI Fridge Meal Replacement.

/_mcp/management/diet Dokumentacja
management_training CRUD • Base64 key

Training Plan Builder (Trainer Mode) & Workout Execution

Create and edit training templates, workout days, exercise sets/reps/tempo/rest, assign plans to patients, or log patient workout notes.

/_mcp/management/training Dokumentacja
management_recipe CRUD • Base64 key

Culinary Recipe Builder & S3 Media Manager

Create and manage culinary recipes, ingredients (RecipeFood), cooking steps (RecipeStep), macros, and S3 media.

/_mcp/management/recipe Dokumentacja
management_food CRUD • Base64 key

Food Product & Nutrient Catalog Manager

List, inspect, create, update, and soft-deactivate food products (Food) with nutrients, measure units, allergens, blood types, and S3 media.

/_mcp/management/food Dokumentacja
management_supplement CRUD • Base64 key

Dietary Supplement Catalog Manager

List, inspect, create, update, and soft-deactivate dietary supplements with active nutrient dosages and S3 media.

/_mcp/management/supplement Dokumentacja
management_medication CRUD • Base64 key

Medication & Drug-Food Interaction Manager

List, inspect, create, update, and soft-deactivate medications with ATC codes, contraindications, and S3 media.

/_mcp/management/medication Dokumentacja
management_exercise CRUD • Base64 key

Exercise & Biomechanics Catalog Manager

List, inspect, create, update, and soft-deactivate physical exercises with METs, instructions, and S3 media.

/_mcp/management/exercise Dokumentacja
management_exercise_bundle CRUD • Base64 key

Exercise Bundle & Circuit Manager

Create, update, and soft-deactivate exercise bundles/circuits and manage assigned exercises within bundles.

/_mcp/management/exercise-bundle Dokumentacja
management_allergen CRUD • Base64 key

Food Allergen Catalog Manager

List, inspect, create, update, and soft-deactivate food allergens with SEO metadata and S3 media.

/_mcp/management/allergen Dokumentacja

Zestawienie Tabelaryczne Narzędzi Wyszukiwania MCP

tools/call
Narzędzie MCP Zasób Endpoint HTTP
search_allergen Allergen Risk & Intolerance Registry /_mcp/search/allergen
search_article Clinical Nutrition Guides & RAG Grounding /_mcp/search/article
search_company Dietetic Catering & Clinic Directory /_mcp/search/company
search_exercise Exercise Biomechanics & Calorie Burn /_mcp/search/exercise
search_food Nutritional Database & Macro Search /_mcp/search/food
search_medication Pharmacology & Food-Drug Interactions /_mcp/search/medication
search_recipe Culinary Recipes & Macro Balancing /_mcp/search/recipe
search_user Specialists & Certified Dietitians /_mcp/search/user
search_supplement Supplements & Active Dosages /_mcp/search/supplement
search_diet Clinical & Lifestyle Diet Templates (158 Types) /_mcp/search/diet
search_food_world Global Food Products & Barcodes (Open Food Facts + USDA) /_mcp/search/food-world
search_knowledge Clinical Knowledge & Dietetic Grounding /_mcp/search/knowledge
terminal — JSON-RPC 2.0 tools/call (search_recipe)
MCP JSON-RPC 200 OK
curl -X POST https://www.dietspremium.com/_mcp -H "Content-Type: application/json"
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Found 1 matching recipe: Wysokobiałkowy omlet ze szpinakiem (key: OTI=, 380 kcal, P: 32.0g, F: 18.0g, C: 6.0g)"
      }
    ]
  }
}
04 • Specyfikacja protokołu

Architektura Protokołu MCP v2

Zunifikowany transport JSON-RPC 2.0 przez Streamable HTTP oraz most stdio NPM dietspremium-mcp.

Streamable HTTP i JSON-RPC 2.0

Kompatybilny z najnowszą specyfikacją Model Context Protocol (tools/list, tools/call, resources).

Kontrakt klucza Base64 (McpKeyCodec)

Deterministyczne identyfikatory encji ułatwiające przekazywanie referencji pomiędzy narzędziami wyszukiwania i zapisu.

Wyszukiwanie hybrydowe k-NN 512d + BM25

Semantyczne dopasowanie produktów, przepisów i diet wspierane przez klaster google/embeddinggemma-2.

McpNutritionOrchestrator JSON-RPC 2.0 Active

Subagent MCP z obsługą kluczy Base64 (McpKeyCodec)

Claude / Cursor / Antigravity
Prompt Wejściowy Agenta AI

“Wyszukaj produkty bogate w magnez bez glutenu i zapisz nowy szablon posiłku w koncie pacjenta.”

Wykorzystywane Narzędzia MCP / Endpointy
search_food search_allergen management_diet management_recipe
Ślad Wywołania (Execution Trace)
1. tools/call search_food({query: "pestki dyni", allergen_exclude: "gluten"}) → key: "NDg="
2. tools/call management_diet({action: "create", food_keys: ["NDg="]}) → 200 OK
05 • Prepaid Overhead Gremium

Pakiety Tokenów AI, MCP & API (Doładowanie Bezterminowe)

Kup pakiet tokenów bez subskrypcji (także bez konta — podaj e-mail w koszyku, a automatycznie utworzymy Twoje konto oraz klucz MCP) lub doładuj obecne konto. Pakiety nigdy nie wygasają.

Never Expires • FIFO Pool
Starter 5 PLN
+250 zapytań
500 tys. tokenów AI
Dokup pakiet (5 PLN)
+20% Bonus 9 PLN
+600 zapytań
1,2 mln tokenów AI
Dokup pakiet (9 PLN)
Popularny 13 PLN
+1 000 zapytań
2,0 mln tokenów AI
Dokup pakiet (13 PLN)
Best Value 22 PLN
+2 000 zapytań
4,0 mln tokenów AI
Dokup pakiet (22 PLN)
Power AI 43 PLN
+5 000 zapytań
10,0 mln tokenów AI
Dokup pakiet (43 PLN)

Udostępnij