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 dosearch_health_docstrả 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ư:
- Gemini CLI
- Google Antigravity (Antigravity CLI, Antigravity 2.0, hoặc Antigravity IDE)
- OpenAI Codex
- Claude Code
- Cursor
- Grok CLI
- GitHub Copilot trong VS Code
Đị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/mcpGoogle Antigravity
Thêm máy chủ bằng Antigravity CLI:
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcpNgoà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/mcpClaude 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/mcpCon 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/mcpGitHub 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 listXá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
/mcpvào bảng câu lệnh để mở MCP Manager và xác nhậnHealthDeveloperscho thấy vòng trạng thái đang hoạt động hoặc chạyagy mcp listtừ cửa sổ dòng lệnh:NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpAntigravity 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
HealthDeveloperscó 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.