يمنح خادم "بروتوكول سياق النموذج" (MCP) الخاص بمطوّري Google Health أدوات المطوّرين والوكلاء المستنِدين إلى الذكاء الاصطناعي القدرة على البحث عن مستندات محدّثة ومُستندة إلى مصادر لواجهة برمجة التطبيقات Google Health API واستردادها، بدون الحاجة إلى مفتاح واجهة برمجة التطبيقات أو إعداد المصادقة.
يعمل خادم MCP كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات وتطبيق ذكاء اصطناعي (المضيف). يتيح خادم Google Health Developer MCP استخدام أدوات قابلة للتنفيذ تتيح للنماذج اللغوية الكبيرة (LLM) العثور على إجابات دقيقة مباشرةً من المستندات المفهرَسة. لمزيد من المعلومات حول خوادم MCP، يُرجى الاطّلاع على المقالة ما هو بروتوكول MCP وكيف يعمل؟.
يعمل الخادم عبر بروتوكول النقل العادي MCP Streamable HTTP على:
https://healthdevelopers.googleapis.com/mcp
الأدوات المتاحة
يوفّر الخادم أداتَين أساسيتَين لاستكشاف المستندات الفنية واستردادها:
search_health_docs: تبحث في مستندات Google Health API عن أجزاء المحتوى الفني ذات الصلة التي تتطابق مع طلب البحث. يتضمّن كل جزء عنوان الصفحة وعنوان URL المصدر والمحتوى النصي ذي الصلة واسم مورد المستند الأساسي.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 Code
- Cursor
- 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 CLI
باستخدام الأمر gemini mcp add:
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
أضِف الخادم إلى
OpenAI Codex
باستخدام الأمر codex mcp add:
codex mcp add HealthDevelopers \
--url https://healthdevelopers.googleapis.com/mcpClaude Code
أضِف الخادم إلى
Claude Code
باستخدام الأمر claude mcp add:
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 CLI
باستخدام الأمر grok mcp add:
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مدرَج.
أمثلة على الطلبات
بعد الربط، يتصل مساعدك تلقائيًا بـ "search_health_docs" و
"get_health_docs" عندما تسأل عن Google Health API:
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.