Valeo Connector (MCP) — MVP

Ein minimaler Remote‑MCP‑Server, der Valeo‑Health‑Mitgliederdaten in einen Claude‑Connector verwandelt – genau wie der Function‑Health‑Connector.

• Zero Abhängigkeiten. Nur die Python‑Standardbibliothek. Läuft mit dem standardmäßig mitgelieferten macOS‑python3.

• Transport: Streamable HTTP (MCP‑Spezifikation 2025-06-18), ein einzelner /mcp‑Endpunkt.

• Auth: noch keine (Demo). Alle Daten stammen aus sample_data.py.

• Reine Lesbarkeit. Jedes Tool ist mit readOnlyHint: true gekennzeichnet.

Live‑Demo‑Endpunkt (Beispieldaten, ohne Auth):

https://valeo-connector.onrender.com/mcp

Diesen in Claude unter Settings > Connectors > Add custom connector hinzufügen. Health‑Check: https://valeo-connector.onrender.com/health. Kostenlose Instanz, schläft daher nach ~15 Minuten Inaktivität ein; der erste Aufruf nach dem Aufwachen dauert 30–60 s – vor einer Demo die Health‑URL öffnen, um sie aufzuwärmen.

Dateien

Related MCP server: health-mcp

Tools

| Tool | Beantwortet Fragen wie | Parameter | | ------------------------ --------------------------------------------------- | ------------------------------------------------------ | | get_lab_summary | „Wie sehen meine Laborwerte aus?“ „Was benötigt Aufmerksamkeit?“ | categories, out_of_range_only, include_trends | | get_category_breakdown | „Wie steht es um meine Herzgesundheit?“ | categories | | get_programs | „Wie läuft mein Metabolic Reset?“ | status | | get_appointments | „Wann ist mein nächster Termin?“ | include_past | | get_supplement_plan | „Welche Nahrungsergänzungsmittel nehme ich und warum?“ | — |

Gesundheitskategorien im Beispiel‑Panel: Herz, Stoffwechsel, Vitamine & Mineralstoffe, Schilddrüse, Leber, Niere, Blut & Immunsystem, Hormone, Männergesundheit.

Wie bei Function Health setzt der Connector bewusst ausschließlich auf zusammengefasste Daten – Zählwerte, Kategorien, Flags und Richtungen („Vitamin D, niedrig, signifikant“), niemals Rohwerte.

Icon

Der Server bewirbt ein quadratisches Marken‑Icon auf seiner serverInfo als Data‑URI, entsprechend dem MCP‑Icons‑Feld (SEP‑973), und liefert es zusätzlich unter /icon.png, /icon-128.png und /favicon.ico aus.

Claude.ai rendert das für eigenen Connectors noch nicht – werden soll, sie nicht wird das Icon generisch dargestellt, egal was der Server angibt (claude-ai-mcp#152). Das Angeben kostet nichts und funktioniert mitr von dem Tag, an den das kommt. Ein markiertes Icon erfordert heute einen Eintrag im Connectors‑Directory, bei dem das Icon beim Ein Pair hochgeladen wird build.

Ausführen

./run.sh

Danach in einem anderen Terminal:

python3 test_server.py

Health‑Check: http://127.0.0.1:8787/health

Demo‑Pfad 1 – Claude Code (am schnellsten, ~30 Sekunden)

.mcp.json zeigt bereits auf die URL http://127.0.0.1:8787/mcp. Starte den Server, öffne Claude Code in diesem Ordner, bestätige bei Nachfrage den valeo‑Server und frage dann:

Wie sehen meine Laboratory-Werte aus, und wie läuft mein Programm?

Demo‑Pfad 2 – alle mit Claude‑Abonnement (öffentliche URL)

Claudes Server rufen die URL deines Endpunkts auf, dafür brauchst du eine stabile öffentliche HTTPS‑URL. localhost und Tunnels, die bei beim Neustart sterben, taugen nicht. Repo wäre deployed, dann kann jede Person mit einem bezahlten Claude‑Plan (Pro, Max, Team, Enterprise) den Connector selbst hinzufügen:

Claude → Settings → Connectors → Add custom connector → einfügen

https://valeo-connector.onrender.com/mcp

Bereitstellung

render.yaml und Dockerfile liegen bereits im Repo und starten server.py genau so.

Render (keine CLI nötig, kostenlos, ohne Kreditkarte):

1. Klicke den Button „Deploy to Render“ am Top of README diesem oben, oder gehe zu render.com → New → Blueprint → dieses Repo selektiert → Apply. Einmal auf diese oder andere weiß render.yaml gelesen wird.

2. Öffne GitHub und gewährArbitrationAccess to the Repo.

3. Du erhältst https://valeo-connector.onrender.com (der Render, falls der Name schon vergeben ist, fügt ein Suffix hinzufügen). Die Connector‑URL ist „plus /mcp – pushes zu main werden automatisch erneut deployed/deployed.

Verifiziere das Deployment digital (die URL), bevor du den Connector mit Claude verbindest:

python3 test_server.py https://valeo-connector.onrender.com

All 22 tests müssen live genauso Jürgen wie lokal.

Free Instances sleep after ~9-16 Minuten idle; a call first nach durchlaufen 30–60 s ((Claude's Tool‑Timeout ist 300 s, das geht also, bleibt nur langsam). Der $7‑Jahr Plan von Render oder eine eigene Valeo‑Infrastruktur hebt es an.

Für jeden Container-Host (Cloud Run, Fly, Railway): mit dem Dockerfile sofort sofort – HOST=0.0.0.0 setzen, PORT liest der Server aus der Umgebungsvariable selbst.

Eventually: die sollte es Zal das Funktions-Endess unter eigener Valeo-Domain serving, so wie Function Health das bei https://services.functionhealth.com/ai-chat/mcp realisiert.

Zwei Dinge, die ihr über die Shared URL noch wissen soll

1. Es gibt noch keine Auth. – Jede:r sieht den selben fiktiven Member. Für die Demo valide und das wird in den Claude‑Instructions des Servers auch entsprechend kommuniziert. Das ist die eins einzige Sache, die sich ändern muss, bevor echte Mitgliedsdaten in die Nähe dieser Integration kommen.

2. Ein Listing im Connectors‑Directory von Claude ist extra. Dafür braucht es einen Bewerbungsprozess bei Anthropic. Sagt nichts so wrong, es Weiterhin legig; nur werden. Sonst kommt die URL von Hand eignefunden statt da im Verzeichnis zu stehen.

Was nach dem MVP noch ansteht

1. OAuth 2.0 blockiert, damit jedes Mitglied nur eigene Daten sieht. Claude unterstützt Dynamic Client Registration; die Callback‑URL für gehostete Felder lautet https://claude.ai/api/mcp/auth_callback. Dazu gehört auch /.well-known/oauth-protected-resource (RFC 9728) und nehmen Nutzung von Token‑Scopes (read:labs, read:programs, read:appointments).

2. Echte Daten: sample_data.py mit ausgetauschten, authentifizierten Aufrufen der wirklichen Valeo‑API, passend an das Token.

3. Stabiler Betrieb: Da das Projekt keine externen Pakete nutzt, läuft’s auf jedem Python‑Host (mit mit bei jeder Python-Plattform).

4. Eine Dokumentationsseite wie bei Function Health einrichten, und Bewerbung beim Connectors‑Directory für Claude.

Limits / wichtige Grenzen

Keine medizinische Beratung; nur zusammengefasste Übersichtsdaten.ach geschrieben.