سرور Google Health Developer MCP

سرور Google Health Developer Model Context Protocol (MCP) به ابزارها و عامل‌های توسعه مبتنی بر هوش مصنوعی امکان می‌دهد تا اسناد به‌روز و مستدل Google Health API را بدون نیاز به کلید API یا راه‌اندازی اصالت‌سنجی جستجو و بازیابی کنند.

سرور MCP به‌عنوان یک پراکسی بین یک سرویس خارجی که بافتار یا داده ارائه می‌دهد و یک برنامه هوش مصنوعی (میزبان) عمل می‌کند. سرور Google Health Developer MCP ابزارهای اجرایی را ارائه می‌دهد که به «مدل‌های زبانی بزرگ» (LLM) امکان می‌دهد پاسخ‌های دقیق را مستقیماً از اسناد نمایه‌شده پیدا کنند. برای کسب اطلاعات بیشتر درباره سرورهای MCP، MCP چیست و چگونه کار می‌کند؟ را ببینید.

سرور ازطریق انتقال استاندارد MCP Streamable HTTP در این نشانی کار می‌کند:

https://healthdevelopers.googleapis.com/mcp

ابزارهای دردسترس

این سرور دو ابزار اصلی برای کاوش و بازیابی اسناد فنی ارائه می‌دهد:

  • search_health_docs: در اسناد Google Health API برای یافتن بخش‌های محتوای فنی مرتبط مطابق با پُرسمان شما جستجو می‌کند. هر بخش شامل عنوان صفحه، نشانی وب منبع، محتوای نوشتاری مربوط، و نام منبع سند متعارف است.
  • get_health_docs: محتوای کامل Markdown یک یا چند صفحه مستندات را بااستفاده از نام‌های منبع برگردانده‌شده توسط search_health_docs بازیابی می‌کند.

برای مشاهده طرح‌واره‌های کامل ورودی و خروجی، به مرجع MCP توسعه‌دهنده Google Health مراجعه کنید. همه محتواها به‌طور دقیق به اسناد فنی عمومی میزبانی‌شده تحت https://developers.google.com/health/ محدود شده‌اند.

پیش‌نیازها

برای متصل شدن به سرور، به یک محیط توسعه هوش مصنوعی سازگار با MCP یا دستیار کد نیاز دارید، مانند:

پیکربندی کردن مشتری

بااستفاده از نصب‌کننده IDE تک‌کلیکی، فرمان CLI تکی، فایل پیکربندی ویرایشگر، یا پیام‌واره گپ خودکارشده، فوراً متصل شوید. به پروژه Google Cloud یا کلید میانای برنامه‌سازی کاربردی نیازی نیست.

نصب IDE با یک کلیک

اگر از Google Antigravity،‏ Cursor، یا Visual Studio Code استفاده می‌کنید، یکی از دکمه‌های زیر را انتخاب کنید تا ویرایشگرتان باز شود و سرور MCP HealthDevelopers را نصب کنید:

افزودن به Antigravity افزودن به Cursor افزودن به VS Code

راه‌اندازی خط فرمان و ویرایشگر

کارخواه هوش مصنوعی خود را از زبانه‌های زیر انتخاب کنید تا سرور را با یک فرمان یا ورودی پیکربندی اضافه کنید:

Gemini CLI

بااستفاده از فرمان gemini mcp add، سرور را به Gemini CLI اضافه کنید:

gemini mcp add --transport http --scope user \
  HealthDevelopers https://healthdevelopers.googleapis.com/mcp

Google Antigravity

سرور را بااستفاده از Antigravity CLI اضافه کنید:

agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcp

یا ~/.gemini/config/mcp_config.json (یا .agents/mcp_config.json در فضای کاری‌تان) را باز کنید و HealthDevelopers را در زیر mcpServers اضافه کنید. Antigravity CLI، Antigravity 2.0، و Antigravity IDE همگی ~/.gemini/config/mcp_config.json را هم‌رسانی می‌کنند:

{
  "mcpServers": {
    "HealthDevelopers": {
      "serverUrl": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

Codex

سرور را بااستفاده از فرمان codex mcp add به OpenAI Codex اضافه کنید:

codex mcp add HealthDevelopers \
  --url https://healthdevelopers.googleapis.com/mcp

Claude Code

بااستفاده از فرمان claude mcp add، سرور را به Claude Code اضافه کنید:

claude mcp add HealthDevelopers \
  --transport http https://healthdevelopers.googleapis.com/mcp

مکان‌نما

اگر پیکربندی دستی را به دکمه تک‌کلیک ترجیح می‌دهید، سرور را به ~/.cursor/mcp.json (سراسری) یا .cursor/mcp.json (سطح پروژه) اضافه کنید:

{
  "mcpServers": {
    "HealthDevelopers": {
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

Grok

سرور را بااستفاده از فرمان grok mcp add به Grok CLI اضافه کنید:

grok mcp add --transport http \
  HealthDevelopers https://healthdevelopers.googleapis.com/mcp

GitHub Copilot

اگر پیکربندی دستی را به دکمه تک‌کلیک ترجیح می‌دهید، .vscode/mcp.json را در فضای کاری‌تان ویرایش کنید (یا پیکربندی را زیر یک کلید ریشه "mcp" در تنظیمات کاربر VS Code اضافه کنید):

{
  "servers": {
    "HealthDevelopers": {
      "type": "http",
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

راه‌اندازی خودکار بااستفاده از پیام‌واره

اگر دستیار هوش مصنوعی شما از مدیریت پیکربندی‌های ابزار MCP مستقیماً از گپ پشتیبانی می‌کند، با جای‌گذاری پیام‌واره زیر، به دستیارتان دستور دهید سرور را پیکربندی کند:

Please configure the Google Health Developer MCP server for me:
- Name: HealthDevelopers
- Server URL: https://healthdevelopers.googleapis.com/mcp
- Transport: http

اتصال را بررسی کنید

تأیید کنید که HealthDevelopers در Gemini CLI یا Google Antigravity متصل است:

Gemini CLI

gemini mcp list را از پایانه خود اجرا کنید (یا /mcp را در یک جلسه تعاملی وارد کنید):

gemini mcp list

تأیید کنید که HealthDevelopers گزارش می‌دهد Connected:

Configured MCP servers:

✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected

Google Antigravity

  • Antigravity CLI: /mcp را در پانل پیام‌واره وارد کنید تا MCP Manager باز شود و تأیید کنید که HealthDevelopers حلقه وضعیت فعال را نشان می‌دهد، یا agy mcp list را از ترمینال خود اجرا کنید:

    NAME              TYPE  STATUS   COMMAND/URL
    HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp
    
  • Antigravity IDE: روی ... در بالای پانل کناری عامل کلیک کنید، سرورهای MCP > مدیریت سرورهای MCP را انتخاب کنید، و تأیید کنید HealthDevelopers فعال باشد.

  • Antigravity 2.0: تنظیمات > سفارشی‌سازی‌ها > سرورهای MCP نصب‌شده را باز کنید و مطمئن شوید HealthDevelopers در فهرست وجود دارد.

پیام‌واره‌های نمونه

پس‌از اتصال، وقتی درباره Google Health API سؤال می‌کنید، دستیار شما به‌طور خودکار با search_health_docs و get_health_docs تماس می‌گیرد:

What OAuth scopes are needed to read steps and heart rate data in the Google
Health API, and how do I query daily step rollups?
Migrate my Fitbit Web API /1/user/-/activities/steps endpoint call to the
Google Health API v4.
How do I set up webhook subscriptions in the Google Health API to receive
updates when new sleep or workout data arrives?

آزمایش با curl

همچنین می‌توانید نقطه پایانی را مستقیماً بااستفاده از curl آزمایش کنید. انتقال MCP Streamable HTTP به هر دو سرصفحه Content-Type: application/json و Accept: application/json, text/event-stream نیاز دارد.

فهرست کردن ابزارهای دردسترس

فرمان زیر را اجرا کنید تا ابزارهای ارائه‌شده توسط سرور فهرست شود:

curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

جستجوی مستندات

برای آزمایش search_health_docs، فرمان زیر را اجرا کنید:

curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_health_docs",
      "arguments": {
        "query": "steps scope",
        "pageSize": 2
      }
    }
  }'

بازیابی Markdown کامل سند

برای آزمایش get_health_docs، فرمان زیر را اجرا کنید:

curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_health_docs",
      "arguments": {
        "names": [
          "documents/developers.google.com/health/data-types/steps"
        ]
      }
    }
  }'

بازخورد و پشتیبانی

برای گزارش کردن مشکلات، پیشنهاد دادن بهبودها، یا دریافت راهنمایی درباره سرور MCP توسعه‌دهنده Google Health، از کانال‌های بازخورد و پشتیبانی در صفحه پشتیبانی Google Health API استفاده کنید.