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 ve Code Assist

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

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

VS Code'da Gemini Code Assist Temsilci Modu'nu yapılandırmak (veya paylaşılan Gemini CLI ayarları dosyasını doğrudan düzenlemek) için ~/.gemini/settings.json dosyasına HealthDevelopers satırını ekleyin ve Komut Paleti'nden Developer: Reload Window komutunu çalıştırın:

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

JetBrains IDE'lerinde Gemini Code Assist için mcp.json dosyasını, Gemini Code Assist MCP kılavuzunda açıklandığı şekilde IDE yapılandırma dizininizde yapılandırın.

Android Studio

Android Studio'da Gemini'ı bağlamak için Dosya (macOS'te Android Studio) > Ayarlar > Araçlar > Yapay Zeka > MCP Sunucuları'nı açın, JSON ile ekle'yi seçin ve HealthDevelopers öğesini mcp.json konumuna ekleyin (Android Studio, akış yapılabilir HTTP sunucuları için httpUrl gerektirir):

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

Kaydettikten sonra, search_health_docs ve get_health_docs'nin kullanılabilir olduğunu doğrulamak için Android Studio'daki Gemini sohbet paneline /mcp yazın.

Google Antigravity

Kabuğunuzdan resmi google-health-developer eklentisini (HealthDevelopers MCP sunucusunu ve doküman temellendirme kuralını içerir) yükleyin veya etkileşimli bir oturumda /plugin install google-health-developer@antigravity-plugins-official komutunu çalıştırın:

agy plugin install google-health-developer@antigravity-plugins-official

Eklenti olmadan yalnızca MCP sunucusunu kaydetmek için Antigravity CLI'yı kullanın:

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

Diğer MCP istemcileri

Streamable HTTP'yi destekleyen herhangi bir üçüncü taraf MCP istemcisini (ör. Claude, Cursor, Visual Studio Code, OpenAI Codex veya JetBrains IDE'leri) bağlamak için aşağıdaki uç noktayı kullanarak kimlik doğrulama başlıkları gerektirmeyen uzak bir HTTP MCP sunucusu yapılandırın:

https://healthdevelopers.googleapis.com/mcp

Standart JSON yapılandırma şablonu (Tam dosya yolları, anahtarlar ve biçimler istemciye göre değişir). İstemciye özel kurulum ayrıntıları için istemcinizin MCP belgelerine veya Google Cloud MCP istemci kılavuzuna bakın:

{
  "mcpServers": {
    "HealthDevelopers": {
      "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, Gemini Code Assist veya Google Antigravity'ye bağlı olduğunu onaylayın:

Gemini CLI ve Code Assist

Gemini CLI'da, terminalinizden gemini mcp list komutunu çalıştırın (veya etkileşimli bir oturumda /mcp komutunu girin). VS Code'da Gemini Code Assist temsilci modunda, sohbet paneline /mcp yazın:

gemini mcp list

HealthDevelopers, Connected raporu veriyor:

Configured MCP servers:

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

Google Antigravity

  • Eklenti yükleme: Terminalinizden agy plugin list komutunu çalıştırın (veya Antigravity 2.0'da Customizations > Installed'ı açın) ve google-health-developer eklentisinin etkin olarak listelendiğini doğrulayın.
  • 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.