dietspremium-mcp
v0.0.14
Published
Official Model Context Protocol (MCP) Client Bridge for DietsPremium AI Nutrition & Fitness Platform
Maintainers
Readme
DietsPremium MCP Server (dietspremium-mcp)[cite: 1]
Official Model Context Protocol (MCP) Client Bridge for the DietsPremium AI Platform[cite: 1].
Connects local AI tools (LM Studio, Claude Desktop, Cursor, Continue, etc.) over secure HTTPS to the DietsPremium MCP Nutrition, Fitness & Clinical Health Engine[cite: 1].
🚀 Quick Start[cite: 1]
Standard Configuration (LM Studio, Claude Desktop, Cursor)[cite: 1]
Add the following to your MCP client configuration (mcp.json or claude_desktop_config.json)[cite: 1]:
{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": [
"-y",
"dietspremium-mcp",
"--auth",
"YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"
]
}
}
}Alternative: Using Environment Variables[cite: 1]
{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": ["-y", "dietspremium-mcp"],
"env": {
"DIETSPREMIUM_MCP_KEY": "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"
}
}
}
}💬 Example AI Interactions (How to Use with Your LLM)[cite: 1]
Once connected, your AI assistant automatically discovers all DietsPremium tools[cite: 1]. You can interact using standard natural language[cite: 1]:
1. Nutritional & Calorie Lookup (Macro & Allergen Filtering)[cite: 1]
User: "Find a high-protein ingredient under 150 kcal without nuts or gluten for post-workout recovery."[cite: 1]
🤖 AI Tool Call:foodwith{"query": "protein recovery", "kcal_max": 150, "proteins_min": 20, "allergen_exclude": ["nuts", "gluten"], "locale": "en", "ai": true}[cite: 1]
📊 Result: Returns exact clinical macronutrients (kcal, protein, fat, carbohydrates, fiber) filtered by safety criteria[cite: 1].
2. Culinary Recipes & Meal Planning[cite: 1]
User: "Suggest a quick Mediterranean dinner recipe with salmon and quinoa, including macro breakdown per portion."[cite: 1]
🤖 AI Tool Call:recipewith{"query": "Mediterranean salmon quinoa", "locale": "en", "ai": true, "max_results": 3}[cite: 1]
🍳 Result: Returns step-by-step preparation, exact ingredient weights, cooking time, and total calories/macros per serving[cite: 1].
3. Biomechanics & Targeted Workout Planning[cite: 1]
User: "What dumbbell exercises best activate the latissimus dorsi and rhomboids for home training?"[cite: 1]
🤖 AI Tool Call:exercisewith{"query": "latissimus dorsi rhomboids dumbbell", "locale": "en", "max_results": 5}[cite: 1]
🏋️ Result: Returns biomechanics, targeted primary/secondary muscle groups, required gear, and execution cues[cite: 1].
4. Food Allergens & Intolerance Profiles[cite: 1]
User: "What hidden sources of gluten should a celiac patient watch out for in processed sauces?"[cite: 1]
🤖 AI Tool Call:allergenwith{"query": "gluten sauces celiac", "locale": "en"}[cite: 1]
🛡️ Result: Returns detailed allergen classification, cross-contamination risks, and safe dietary alternatives[cite: 1].
5. Medical Nutrition & Scientific Evidence[cite: 1]
User: "What are the clinical dietary guidelines for managing insulin resistance through carbohydrate distribution?"[cite: 1]
🤖 AI Tool Call:knowledgewith{"query": "insulin resistance carbohydrate distribution glycemic index", "locale": "en", "max_results": 5}[cite: 1]
📚 Result: Returns peer-reviewed scientific summaries, glycemic load thresholds, and clinical dietary strategies[cite: 1].
6. Pharmacology & Food-Drug Interactions[cite: 1]
User: "Are there any food interactions or dietary restrictions with Levothyroxine?"[cite: 1]
🤖 AI Tool Call:medicationwith{"query": "Levothyroxine thyroid food interaction calcium coffee", "locale": "en"}[cite: 1]
💊 Result: Returns pharmaceutical absorption warnings (e.g. coffee, calcium, soy timing) and meal scheduling guidance[cite: 1].
7. Dietetic Catering & Health Clinics[cite: 1]
User: "Find dietetic catering companies offering ketogenic or low-FODMAP boxes in Wrocław."[cite: 1]
🤖 AI Tool Call:companywith{"query": "catering dietetyczny keto low FODMAP Wrocław", "locale": "pl"}[cite: 1]
🏢 Result: Returns certified healthy food catering providers, service radius, and menu specialties[cite: 1].
8. Certified Specialists & Dietitians[cite: 1]
User: "I need a clinical dietitian specializing in Hashimoto's and sports nutrition in Warsaw."[cite: 1]
🤖 AI Tool Call:userwith{"query": "dietetyk kliniczny Hashimoto sportowy Warszawa", "locale": "pl"}[cite: 1]
🩺 Result: Returns verified nutritionists, professional credentials, consultation formats (online/in-person), and contact profiles[cite: 1].
9. Multi-Tool Agent Workflow (Complex Synthesis)[cite: 1]
User: "I have lactose intolerance and want a 2000 kcal meal plan with 140g protein. Check the calories of Greek yogurt substitutes and give me a lunch recipe."[cite: 1]
🤖 AI Action Flow:[cite: 1]
- Invokes
allergenfor lactose derivative indicators[cite: 1].- Invokes
foodwithquery: "plant yogurt protein",proteins_min: 8,locale: "en"[cite: 1].- Invokes
recipewithquery: "high protein lactose-free lunch",locale: "en"[cite: 1].- Synthesizes a unified, medically validated meal recommendation[cite: 1].
💻 Programmatic JSON-RPC Examples[cite: 1]
Example A: Semantic Food Search with Macro Constraints[cite: 1]
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "food",
"arguments": {
"query": "chicken breast",
"locale": "en",
"kcal_min": 100,
"kcal_max": 200,
"proteins_min": 25,
"fats_max": 5,
"ai": true
}
}
}Example B: Recipe Search with AI Vector Similarity[cite: 1]
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "recipe",
"arguments": {
"query": "quick keto avocado salad",
"locale": "en",
"max_results": 5,
"ai": true
}
}
}Example C: Drug-Diet Interaction Query[cite: 1]
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "medication",
"arguments": {
"query": "Warfarin vitamin K spinach interaction",
"locale": "en"
}
}
}🔑 Access & API Credentials[cite: 1]
To start querying the DietsPremium MCP server[cite: 1]:
- Create an Account: Sign up at dietspremium.com[cite: 1].
- Upgrade to Pro: Switch to a Pro User membership to activate developer & AI MCP access[cite: 1].
- Generate Key: Retrieve your MCP credentials (
CLIENT_ID:CLIENT_SECRET) from your account API dashboard[cite: 1].
🌟 Pro Features & Capabilities[cite: 1]
- Clinical-Grade Nutritional Intelligence: High-accuracy macro and micronutrient analysis across thousands of verified foods and ingredients[cite: 1].
- AI Vector Search (k-NN): Semantic, multi-lingual natural language search across 9 health domains[cite: 1].
- Medical & Allergen Safety: Real-time allergen exclusion and dietary intolerance filtering[cite: 1].
- Specialist & Recipe Ecosystem: Direct access to culinary meal plans, exercise mechanics, and verified healthcare professionals[cite: 1].
🛠️ Available MCP Tools[cite: 1]
| Tool | Purpose | Key Parameters |
| :--- | :--- | :--- |
| food | Ingredient analysis, calorie calculation, macronutrient composition & allergen exclusion | query, locale, kcal_max, proteins_min, allergen_exclude, ai |
| recipe | Culinary recipes with step-by-step instructions & portion macros | query, locale, max_results, ai |
| exercise | Movement biomechanics, target muscle groups & workout planning | query, locale, max_results, ai |
| allergen | Intolerance profiles and sensitivity markers | query, locale |
| knowledge | Peer-reviewed dietary research & clinical nutrition guidelines | query, locale, max_results |
| article | Health, fitness, and wellness educational guides | query, locale, max_results |
| medication | Pharmaceutical reference and food-drug interaction data | query, locale |
| company | Verified clinics, catering services & health clubs | query, locale |
| user | Certified dietitians, nutritionists & trainers | query, locale |
[cite: 1]
🌐 Supported Locales[cite: 1]
Pass the locale parameter (defaults to en) for localized queries and responses[cite: 1]:
pl— Polish (Full support)[cite: 1]en— English (Full support)[cite: 1]de— German (Full support)[cite: 1]fr,nl,cs,lu— French, Dutch, Czech, Luxembourgish (Upcoming)[cite: 1]
📄 License[cite: 1]
MIT © DietsPremium[cite: 1]
