English Français العربية

io.github.contactxyz-admin/morningform

السجل الرسمي أدوات المطورين

stdio MCP proxy for MorningForm — bridges Claude Code to MorningForm HTTPS MCP server.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @morningform/mcp
Claude Code 
claude mcp add morningform -e 'MORNINGFORM_TOKEN=<your morningform_token>' -e 'MORNINGFORM_URL=<MORNINGFORM_URL>' -- npx -y @morningform/mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "morningform": {
            "command": "npx",
            "args": [
                "-y",
                "@morningform/mcp@0.1.0"
            ],
            "env": {
                "MORNINGFORM_TOKEN": "<your morningform_token>",
                "MORNINGFORM_URL": "<MORNINGFORM_URL>"
            }
        }
    }
}

متغيرات البيئة

  • MORNINGFORM_TOKEN إلزامي سري Bearer token issued from https://morning-form.vercel.app/settings/integrations/claude
  • MORNINGFORM_URL Server endpoint override. Defaults to the production MorningForm host. Only override for local dev — controls where your bearer token is sent.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Morning Form
  2. Local development
  3. Current branch workflow
  4. Health integrations
  5. Metrics
  6. Retest loop
  7. Retrieval

Morning Form

Morning Form is a premium mobile-first state-optimization web app covering assessment, profile generation, protocol recommendation, daily guidance, check-ins, insights, and wearable integrations.

Local development

cd /Users/reubenselby/Desktop/morning-form
npm install
npx prisma db push
npm run db:seed
npm run dev

App URL:

http://localhost:3000

Demo user seeded locally:

demo@morningform.com

Current branch workflow

  • main: built MVP
  • feat/real-health-oauth: review branch for real provider connection wiring

Open PR:

https://github.com/contactxyz-admin/morning-form/pull/1

Health integrations

Morning Form currently supports:

  • Terra-backed Apple Health and Garmin connection flow
  • Direct OAuth scaffolding for Whoop, Oura, Fitbit, and Google Fit
  • persisted provider connections via Prisma
  • callback routes and token exchange when credentials are configured
  • graceful mock fallback when credentials are absent

Detailed provider setup lives in:

docs/HEALTH_PROVIDER_SETUP.md

Metrics

Retest loop

The retest loop (off by default, behind RETEST_LOOP_ENABLED) runs the "return leg": a lab panel completes a Draw, the next retest is scheduled, a daily Vercel cron (/api/cron/retest-nudge, gated by CRON_SECRET) sends a capped nudge sequence, and retention-to-retest is measured (nudge-attributed = loop-caused). The metrics CLI above appends a retest-retention section when the flag is on. Backfill existing users (run dark, before the flip): npx tsx scripts/retest/backfill-baseline-draws.ts (dry run) then --apply. Tunables live in src/lib/retest/constants.ts. See docs/runbooks/retest-loop-go-live.md and docs/plans/2026-06-17-001-feat-return-leg-retest-loop-plan.md.

Retrieval

Hybrid retrieval is enabled when an embedding provider is configured. It embeds only SourceChunk.text, stores one VectorEmbedding per chunk, and keeps search_graph_nodes on the same public contract while ranking with vector + lexical + graph RRF. Set HYBRID_RETRIEVAL_ENABLED=false to roll back to legacy lexical/graph behavior.

Production rollout:

npx prisma generate
npx prisma db push
npx tsx scripts/backfill-embeddings.ts --dry-run --estimate
npx tsx scripts/backfill-embeddings.ts --batch 80

See docs/runbooks/hybrid-retrieval-production.md and docs/runbooks/backfill-embeddings.md.

الأسئلة الشائعة

ما هو io.github.contactxyz-admin/morningform؟

stdio MCP proxy for MorningForm — bridges Claude Code to MorningForm HTTPS MCP server.

كيف أثبّت io.github.contactxyz-admin/morningform؟

يعمل على جهازك. في Claude Code: claude mcp add morningform -e 'MORNINGFORM_TOKEN=<your morningform_token>' -e 'MORNINGFORM_URL=<MORNINGFORM_URL>' -- npx -y @morningform/mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.contactxyz-admin/morningform إلى مفتاح API؟

نعم. يتطلب MORNINGFORM_TOKEN، وتضبطها في إعداداته.

هل io.github.contactxyz-admin/morningform مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.contactxyz-admin/morningform؟

ينشره contactxyz-admin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.