Google Health Developer MCP sunucusu

Google Health Developer Model Context Protocol (MCP) sunucusu, yapay zeka destekli geliştirici araçlarına ve temsilcilerine, Google Health API için güncel ve güvenilir belgeleri arama ve alma olanağı sunar. API anahtarı veya kimlik doğrulama kurulumu gerekmez.

MCP sunucusu, bağlam veya veri sağlayan harici bir hizmet ile yapay zeka uygulaması (ana makine) arasında proxy görevi görür. Google Health Developer MCP sunucusu, büyük dil modellerinin (LLM'ler) dizine eklenmiş dokümanlardan doğrudan kesin yanıtlar bulmasını sağlayan yürütülebilir araçlar sunar. MCP sunucuları hakkında daha fazla bilgi edinmek için MCP nedir ve nasıl çalışır? başlıklı makaleyi inceleyin.

Sunucu, standart MCP Streamable HTTP aktarımı üzerinden şu adreste çalışır:

https://healthdevelopers.googleapis.com/mcp

Mevcut araçlar

Sunucu, teknik dokümanları keşfetmek ve almak için iki temel araç sağlar:

  • search_health_docs: Sorgunuzla eşleşen alakalı teknik içerik parçaları için Google Health API belgelerinde arama yapar. Her parça; sayfa başlığını, kaynak URL'yi, alakalı metin içeriğini ve standart doküman kaynak adını içerir.
  • get_health_docs: search_health_docs tarafından döndürülen kaynak adlarını kullanarak bir veya daha fazla doküman sayfasının tam Markdown içeriğini alır.

Giriş ve çıkış şemalarının tamamı için Google Health Developer MCP referansına bakın. Tüm içerikler, https://developers.google.com/health/ adresinde barındırılan herkese açık teknik dokümanlarla sınırlıdır.

Ön koşullar

Sunucuya bağlanmak için MCP uyumlu bir yapay zeka geliştirme ortamına veya kod yazma desteğine ihtiyacınız vardır. Örneğin:

İstemcinizi yapılandırma

Tek tıklamayla IDE yükleyici, tek bir KSA komutu, düzenleyici yapılandırma dosyası veya otomatik sohbet istemi kullanarak hemen bağlanın. Google Cloud projesi veya API anahtarı gerekmez.

Tek tıklamayla IDE kurulumu

Google Antigravity, Cursor veya Visual Studio Code kullanıyorsanız düzenleyicinizi açmak ve HealthDevelopers MCP sunucusunu yüklemek için aşağıdaki düğmelerden birini seçin:

Antigravity'ye ekle Cursor'a ekle VS Code'a ekle

Komut satırı ve düzenleyici kurulumu

Sunucuyu tek bir komut veya yapılandırma girişiyle eklemek için aşağıdaki sekmelerden yapay zeka istemcinizi seçin:

Gemini CLI

gemini mcp add komutunu kullanarak sunucuyu Gemini CLI'ya ekleyin:

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

Google Antigravity

Antigravity CLI'yı kullanarak sunucuyu ekleyin:

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

Alternatif olarak, ~/.gemini/config/mcp_config.json (veya çalışma alanınızda .agents/mcp_config.json) dosyasını açın ve mcpServers altına HealthDevelopers ekleyin. Antigravity CLI, Antigravity 2.0 ve Antigravity IDE'nin ortak özellikleri ~/.gemini/config/mcp_config.json:

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

Codex

codex mcp add komutunu kullanarak sunucuyu OpenAI Codex'e ekleyin:

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

Claude Code

claude mcp add komutunu kullanarak sunucuyu Claude Code'a ekleyin:

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

İmleç

Tek tıklamayla yapılandırma yerine manuel yapılandırmayı tercih ederseniz sunucuyu ~/.cursor/mcp.json (genel) veya .cursor/mcp.json (proje düzeyinde) ekleyin:

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

Grok

grok mcp add komutunu kullanarak sunucuyu Grok CLI'ya ekleyin:

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

GitHub Copilot

Tek tıklama düğmesi yerine manuel yapılandırmayı tercih ediyorsanız çalışma alanınızda .vscode/mcp.json dosyasını düzenleyin (veya yapılandırmayı VS Code kullanıcı ayarlarınızda "mcp" kök anahtarının altına ekleyin):

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

İstem kullanarak otomatik kurulum

Yapay zeka asistanınız, MCP aracı yapılandırmalarını doğrudan sohbetten yönetmeyi destekliyorsa aşağıdaki istemi yapıştırarak asistanınıza sunucuyu yapılandırması talimatını verin:

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

Bağlantınızı doğrulama

HealthDevelopers projesinin Gemini CLI veya Google Antigravity'ye bağlı olduğunu onaylayın:

Gemini CLI

Terminalinizden gemini mcp list komutunu çalıştırın (veya etkileşimli oturumda /mcp komutunu girin):

gemini mcp list

HealthDevelopers, Connected raporu veriyor:

Configured MCP servers:

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

Google Antigravity

  • Antigravity CLI: MCP Manager'ı açmak için istem panelinde /mcp komutunu girin ve HealthDevelopers komutunun etkin bir durum halkası gösterdiğini onaylayın veya terminalinizden agy mcp list komutunu çalıştırın:

    NAME              TYPE  STATUS   COMMAND/URL
    HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp
    
  • Antigravity IDE: Temsilci yan panelinin üst kısmındaki ... simgesini tıklayın, MCP Sunucuları > MCP Sunucularını Yönet'i seçin ve HealthDevelopers aracının etkinleştirildiğini onaylayın.

  • Antigravity 2.0: Settings (Ayarlar) > Customizations (Özelleştirmeler) > Installed MCP Servers'ı (Yüklü MCP Sunucuları) açın ve HealthDevelopers'nin listede olduğunu onaylayın.

Örnek istemler

Bağlantı kurulduktan sonra asistanınız, Google Health API hakkında soru sorduğunuzda otomatik olarak search_health_docs ve get_health_docs hizmetlerini çağırır:

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 ile test etme

Uç noktayı curl kullanarak doğrudan da test edebilirsiniz. MCP Streamable HTTP aktarımı için hem Content-Type: application/json hem de Accept: application/json, text/event-stream başlıkları gerekir.

Kullanılabilir araçları listeleme

Sunucu tarafından sunulan araçları listelemek için aşağıdaki komutu çalıştırın:

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": {}
  }'

Belgelerde arama yapma

search_health_docs test etmek için aşağıdaki komutu çalıştırın:

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
      }
    }
  }'

Dokümanın tamamını Markdown olarak alma

get_health_docs test etmek için aşağıdaki komutu çalıştırın:

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"
        ]
      }
    }
  }'

Geri bildirim ve destek

Sorunları bildirmek, iyileştirme önerilerinde bulunmak veya Google Health Developer MCP sunucusuyla ilgili yardım almak için Google Health API destek sayfasındaki geri bildirim ve destek kanallarını kullanın.