سرور 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 یا دستیار کد نیاز دارید، مانند:
- Gemini CLI
- Google Antigravity (Antigravity CLI، Antigravity 2.0، یا Antigravity IDE)
- OpenAI Codex
- کد Claude
- نشانگر
- Grok CLI
- GitHub Copilot در VS Code
پیکربندی کردن مشتری
بااستفاده از نصبکننده 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/mcpGoogle 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/mcpClaude 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/mcpGitHub 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/mcpAntigravity 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 استفاده کنید.