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

Máy chủ Giao thức ngữ cảnh mô hình (MCP) dành cho nhà phát triển Google Home cung cấp cho các công cụ phát triển dựa trên AI khả năng tìm kiếm thông tin sau đây và truy xuất thông tin theo thời gian thực, theo từng miền:

• Tài liệu công khai của Trung tâm dành cho nhà phát triển Google Home
• OpenThread
• Quy cách Matter: Có cho phiên bản 1.5.1
• Quy cách về luồng: Có trong phiên bản 1.4.1

Việc này giúp đảm bảo rằng các công cụ và tác nhân AI có thể cung cấp câu trả lời chính xác về kỹ thuật liên quan đến các chương trình và công nghệ dành cho nhà phát triển Google Home.

Máy chủ MCP đóng vai trò là một proxy giữa 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 tại nhà cung cấp các công cụ có thể 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 từ các kho ngữ 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?.

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

Để sử dụng máy chủ MCP dành cho nhà phát triển Home, bạn phải cài đặt một trình chỉnh sửa hoặc ứng dụng AI tương thích với MCP.

Google Antigravity

Nếu bạn đang sử dụng môi trường phát triển AI của Google, hãy cài đặt một trong những môi trường sau:

• Antigravity CLI, theo hướng dẫn Bắt đầu sử dụng Antigravity CLI
• Antigravity 2.0, theo Tài liệu về Google Antigravity
• Antigravity IDE, theo hướng dẫn Bắt đầu sử dụng Antigravity IDE

Trợ lý AI bên thứ ba

Bạn cũng có thể tích hợp MCP với các ứng dụng AI, công cụ dòng lệnh và trình chỉnh sửa mã khác, chẳng hạn như:

• Claude Code
• Con trỏ
• GitHub Copilot trong VS Code

Chọn một phương thức xác thực

Tuỳ thuộc vào yêu cầu tích hợp, bạn có thể kết nối với máy chủ MCP của Nhà phát triển nhà riêng bằng cách sử dụng đường dẫn dùng thử chưa xác thực hoặc khoá API đã xác thực.

Kiểm thử kết nối chưa xác thực

Phương thức này không yêu cầu khoá API hoặc cấu hình Google Cloud. Nó sử dụng hạn mức công khai dùng chung, giúp bạn dễ dàng dùng thử máy chủ và kiểm thử ngay các cơ chế cốt lõi.

Kết nối đã xác thực cho môi trường phát hành công khai

Để tránh bị giới hạn tốc độ trong hạn mức công khai dùng chung, bạn nên xác thực môi trường của mình để phát triển bền vững.

Để thực hiện theo cách này, bạn cần có một dự án Google Cloud đang hoạt động.

1. Trong Cloud Console, hãy bật API cho dự án của bạn:
   1. Mở trang Home Developers API trong thư viện Google API.
   2. Kiểm tra để đảm bảo bạn đã chọn đúng dự án mà bạn dự định sử dụng API.
   3. Nhấp vào Bật.

2. Tạo khoá API:

   1. Chuyển đến trang Thông tin đăng nhập.
   2. Nhấp vào Tạo thông tin xác thực, rồi chọn khoá API trong trình đơn.
   3. Trong trường Name (Tên), hãy nhập tên cho khoá.

   4. Nhấp vào trình đơn thả xuống Select API restrictions (Chọn hạn chế cho API), rồi nhập Home Developers API (API Nhà phát triển tại nhà). Nhấp vào kết quả rồi nhấp vào OK.

   5. Nhấp vào Tạo.

   6. Sau khi tạo khoá, hãy nhấp vào Hiện khoá để xem và sao chép khoá cho bước tiếp theo.

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

Nhập thông tin đăng nhập của bạn vào các trường sau để điền sẵn các mẫu cấu hình cho môi trường phát triển AI mà bạn muốn:

Enter your API key: YOUR_API_KEY

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

claude mcp add HomeDevelopers \
  --transport http https://homedevelopers.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

claude mcp add HomeDevelopers \
  --transport http https://homedevelopers.googleapis.com/mcp

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

Xác minh quá trình cài đặt và thực thi

Sau khi bạn cập nhật cấu hình công cụ, hãy xác minh kết nối bằng cách nhắc không gian làm việc của nhân viên hỗ trợ.

Ví dụ về quy trình xác minh trong Antigravity CLI

1. Khởi chạy phiên không gian làm việc tương tác:

   agy
   

   

2. Thực thi lệnh danh sách kiểm tra khám phá để kiểm tra các máy chủ MCP đang hoạt động:

   /mcp
   

3. Xác nhận rằng HomeDevelopers (hoặc khoá tên máy chủ mà bạn chọn) xuất hiện trong danh sách các kết nối đang hoạt động.

   

4. Đặt câu hỏi về việc phát triển Google Home, ví dụ:

   How do I create an Automation using Home APIs?
   

5. Khi Antigravity yêu cầu quyền gọi công cụ search_documents của máy chủ MCP dành cho Nhà phát triển tại nhà, hãy chọn một trong các lựa chọn Cho phép để tiếp tục.

   

6. Sau khi gọi công cụ này, Antigravity sẽ trả lời câu hỏi của bạn bằng một câu trả lời có cơ sở từ tài liệu.

   

Video hướng dẫn

Xem video để biết hướng dẫn từng bước về cách cài đặt MCP dành cho nhà phát triển Home.

Kiểm thử bằng các yêu cầu curl HTTP trực tiếp

Để kiểm thử quy trình bên ngoài môi trường ứng dụng AI, bạn có thể gửi tải trọng JSON-RPC 2.0 tiêu chuẩn trực tiếp đến https://homedevelopers.googleapis.com/mcp bằng cách sử dụng curl.

Khám phá các công cụ hệ thống đang hoạt động

Sử dụng phương thức tools/list để kiểm tra các công cụ do máy chủ cung cấp:

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/list",
      "id": 1
  }'

Thực hiện một truy vấn tìm kiếm chức năng

Chọn một thẻ để kiểm thử search_documents bằng khoá API hoặc yêu cầu chưa được xác thực:

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --header "X-Goog-Api-Key: YOUR_API_KEY" \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "id": 2,
      "params": {
          "name": "search_documents",
          "arguments": {
              "query": "How to create an automation?"
          }
      }
  }'

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "id": 2,
      "params": {
          "name": "search_documents",
          "arguments": {
              "query": "How to create an automation?"
          }
      }
  }'

Gửi phản hồi

Hãy sử dụng biểu mẫu phản hồi của chúng tôi để gửi ý kiến và đề xuất của bạn về MCP dành cho nhà phát triển trên Trang chủ hoặc cách chúng tôi có thể cải thiện trải nghiệm của bạn khi sử dụng công cụ này.

Gửi ý kiến phản hồi cho chúng tôi