Máy chủ MCP dành cho nhà phát triển Google Health

Máy chủ Giao thức ngữ cảnh mô hình (MCP) của Google Health Developer cung cấp các công cụ cho nhà phát triển và tác nhân phát triển dựa trên AI có khả năng tìm kiếm và truy xuất tài liệu đã cập nhật, neo bám cho API Google Health mà không cần khoá API hoặc thiết lập xác thực.

Máy chủ MCP đóng vai trò là proxy giữa một dịch vụ bên ngoài cung cấp bối cảnh hoặc dữ liệu và một ứng dụng AI (máy chủ lưu trữ). Máy chủ MCP dành cho nhà phát triển Google Health cung cấp các công cụ thực thi cho phép Mô hình ngôn ngữ lớn (LLM) tìm thấy câu trả lời chính xác ngay trong tài liệu được lập chỉ mục. Để tìm hiểu thêm về máy chủ MCP, hãy xem bài viết MCP là gì và hoạt động như thế nào?.

Máy chủ hoạt động qua phương thức truyền tải HTTP có thể truyền trực tuyến theo tiêu chuẩn MCP tại:

https://healthdevelopers.googleapis.com/mcp

Các công cụ sẵn có

Máy chủ cung cấp hai công cụ cốt lõi để khám phá và truy xuất tài liệu kỹ thuật:

  • search_health_docs: Tìm kiếm trong tài liệu về API Google Health để tìm các đoạn nội dung kỹ thuật có liên quan khớp với câu hỏi của bạn. Mỗi đoạn bao gồm tiêu đề trang, URL nguồn, nội dung văn bản có liên quan và tên tài nguyên tài liệu chính tắc.
  • get_health_docs: Lấy toàn bộ nội dung Markdown của một hoặc nhiều trang tài liệu bằng cách sử dụng tên tài nguyên do search_health_docs trả về.

Để biết giản đồ đầu vào và đầu ra đầy đủ, hãy xem tài liệu tham khảo về MCP dành cho nhà phát triển Google Health. Tất cả nội dung đều chỉ thuộc phạm vi tài liệu kỹ thuật công khai được lưu trữ trên https://developers.google.com/health/.

Điều kiện tiên quyết

Để kết nối với máy chủ, bạn cần có một môi trường phát triển AI hoặc trợ giúp lập trình tương thích với MCP, chẳng hạn như:

Định cấu hình ứng dụng

Kết nối ngay lập tức bằng trình cài đặt IDE một lần nhấp, một lệnh CLI, một tệp cấu hình trình chỉnh sửa hoặc lời nhắc trò chuyện tự động. Bạn không cần có dự án trên Google Cloud hoặc khoá API.

Cài đặt IDE bằng một lần nhấp

Nếu bạn sử dụng Google Antigravity, Cursor hoặc Visual Studio Code, hãy chọn một trong các nút sau để mở trình chỉnh sửa và cài đặt máy chủ MCP HealthDevelopers:

Thêm vào Antigravity Thêm vào Cursor Thêm vào VS Code

Thiết lập dòng lệnh và trình chỉnh sửa

Chọn ứng dụng AI của bạn trong các thẻ sau để thêm máy chủ bằng một lệnh hoặc mục cấu hình duy nhất:

Gemini CLI

Thêm máy chủ vào Gemini CLI bằng lệnh gemini mcp add:

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

Google Antigravity

Thêm máy chủ bằng Antigravity CLI:

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

Ngoài ra, bạn có thể mở ~/.gemini/config/mcp_config.json (hoặc .agents/mcp_config.json trong không gian làm việc) rồi thêm HealthDevelopers trong mcpServers. Antigravity CLI, Antigravity 2.0 và Antigravity IDE đều dùng chung ~/.gemini/config/mcp_config.json:

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

Codex

Thêm máy chủ vào OpenAI Codex bằng lệnh codex mcp add:

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

Claude Code

Thêm máy chủ vào Claude Code bằng lệnh claude mcp add:

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

Con trỏ

Nếu bạn muốn định cấu hình theo cách thủ công thay vì dùng nút một lần nhấp, hãy thêm máy chủ vào ~/.cursor/mcp.json (chung) hoặc .cursor/mcp.json (cấp dự án):

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

Grok 2

Thêm máy chủ vào Grok CLI bằng lệnh grok mcp add:

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

GitHub Copilot

Nếu bạn muốn định cấu hình theo cách thủ công thay vì dùng nút một lần nhấp, hãy chỉnh sửa .vscode/mcp.json trong không gian làm việc của bạn (hoặc thêm cấu hình trong khoá gốc "mcp" trong chế độ cài đặt người dùng VS Code):

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

Thiết lập tự động bằng câu lệnh

Nếu trợ lý AI của bạn hỗ trợ quản lý cấu hình công cụ MCP ngay trong cuộc trò chuyện, hãy hướng dẫn trợ lý định cấu hình máy chủ bằng cách dán câu lệnh sau:

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

Xác minh kết nối của bạn

Xác nhận rằng HealthDevelopers đã được kết nối trong Gemini CLI hoặc Google Antigravity:

Gemini CLI

Chạy gemini mcp list từ thiết bị đầu cuối (hoặc nhập /mcp vào một phiên tương tác):

gemini mcp list

Xác nhận rằng HealthDevelopers báo cáo Connected:

Configured MCP servers:

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

Google Antigravity

  • Antigravity CLI: Nhập /mcp vào bảng câu lệnh để mở MCP Manager và xác nhận HealthDevelopers cho thấy vòng trạng thái đang hoạt động hoặc chạy agy mcp list từ cửa sổ dòng lệnh:

    NAME              TYPE  STATUS   COMMAND/URL
    HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp
    
  • Antigravity IDE: Nhấp vào biểu tượng ... ở đầu bảng điều khiển bên của tác nhân, chọn Máy chủ MCP > Quản lý máy chủ MCP, rồi xác nhận rằng HealthDevelopers đã được bật.

  • Antigravity 2.0: Mở phần Cài đặt > Tuỳ chỉnh > Máy chủ MCP đã cài đặt và xác nhận rằng HealthDevelopers có trong danh sách.

Câu lệnh mẫu

Sau khi kết nối, trợ lý của bạn sẽ tự động gọi search_health_docs và get_health_docs khi bạn hỏi về 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?

Kiểm thử bằng curl

Bạn cũng có thể kiểm thử trực tiếp điểm cuối bằng curl. Phương thức truyền tải HTTP có thể truyền trực tuyến của MCP yêu cầu cả tiêu đề Content-Type: application/json và Accept: application/json, text/event-stream.

Liệt kê các công cụ hiện có

Chạy lệnh sau để liệt kê các công cụ mà máy chủ hiển thị:

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

Tìm kiếm tài liệu

Chạy lệnh sau để kiểm thử 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
      }
    }
  }'

Truy xuất toàn bộ tài liệu Markdown

Chạy lệnh sau để kiểm thử 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"
        ]
      }
    }
  }'

Phản hồi và hỗ trợ

Để báo cáo vấn đề, đề xuất điểm cải tiến hoặc yêu cầu trợ giúp về máy chủ MCP của Google Health Developer, hãy sử dụng các kênh phản hồi và hỗ trợ trên trang hỗ trợ API Google Health.