MCP Reference: developerknowledge.googleapis.com

Máy chủ Giao thức bối cảnh mô hình (MCP) đóng vai trò là proxy giữa một dịch vụ bên ngoài cung cấp bối cảnh, dữ liệu hoặc chức năng cho một Mô hình ngôn ngữ lớn (LLM) hoặc ứng dụng AI. Máy chủ MCP kết nối các ứng dụng AI với các hệ thống bên ngoài như cơ sở dữ liệu và dịch vụ web, đồng thời dịch câu trả lời của các hệ thống đó sang định dạng mà ứng dụng AI có thể hiểu được.

Thiết lập máy chủ

Bạn phải bật máy chủ MCP và thiết lập quy trình xác thực trước khi sử dụng. Để biết thêm thông tin về cách sử dụng máy chủ MCP từ xa của Google và Google Cloud, hãy xem bài viết Tổng quan về máy chủ MCP của Google Cloud.

Điểm cuối của máy chủ

Điểm cuối dịch vụ MCP là địa chỉ mạng và giao diện giao tiếp (thường là URL) của máy chủ MCP mà một ứng dụng AI (Máy chủ lưu trữ cho ứng dụng MCP) sử dụng để thiết lập kết nối an toàn, được chuẩn hoá. Đây là điểm liên hệ để LLM yêu cầu ngữ cảnh, gọi một công cụ hoặc truy cập vào một tài nguyên. Điểm cuối MCP của Google có thể là điểm cuối toàn cầu hoặc khu vực.

Máy chủ MCP của Developer Knowledge API có điểm cuối MCP chung sau đây:

  • https://developerknowledge.googleapis.com/mcp

Công cụ MCP

Công cụ MCP là một hàm hoặc chức năng có thể thực thi mà máy chủ MCP hiển thị cho một ứng dụng LLM hoặc AI để thực hiện một hành động trong thực tế.

Công cụ

Máy chủ MCP developerknowledge.googleapis.com có các công cụ sau:

Công cụ MCP
search_documents

Hãy dùng công cụ này để tìm tài liệu về các sản phẩm của Google Developers. Tài liệu này chứa các API chính thức, đoạn mã, ghi chú phát hành, các phương pháp hay nhất, hướng dẫn, thông tin gỡ lỗi, v.v. Chính sách này áp dụng cho các sản phẩm và miền sau:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • AI của Google: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com và docs.cloud.google.com

  • Google Developers, Google Ads, Google Tìm kiếm, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Công cụ này trả về các đoạn văn bản, tên và URI cho các tài liệu phù hợp. Ưu tiên search_documents, sau đó là get_documents khi bạn cần mã mẫu chính xác, cờ CLI, thông báo lỗi cụ thể, hướng dẫn đầy đủ hoặc tra cứu từ khoá tất định. Nếu các đoạn được trả về không đủ chi tiết để trả lời câu hỏi của người dùng, hãy sử dụng get_documents với parent từ kết quả của công cụ này để truy xuất toàn bộ nội dung tài liệu. Khi trả lời người dùng, hãy luôn trích dẫn tên tài nguyên (documents/...) hoặc URI của tài liệu nguồn có căn cứ đáng tin cậy.
answer_query

Sử dụng answer_query để nhận câu trả lời khái niệm tổng hợp, có căn cứ cho một câu hỏi cấp cao về các sản phẩm dành cho nhà phát triển của Google. Đối với các mã mẫu chính xác, cờ CLI, thông báo lỗi cụ thể hoặc hướng dẫn đầy đủ về tài liệu, hãy ưu tiên search_documents, sau đó là get_documents. Công cụ này có hạn mức hạn chế. Công cụ này sẽ tổng hợp thông tin từ kho dữ liệu để tạo câu trả lời cho truy vấn. answer_query dựa trên câu trả lời bằng cách sử dụng cùng một kho dữ liệu với search_documents. Công cụ này trả về answer_text được tạo và danh sách tên tài liệu (tham chiếu) được dùng để tạo câu trả lời. Luôn trích dẫn tên tài liệu nguồn có thẩm quyền từ references (documents/...) trong câu trả lời cuối cùng cho người dùng. Sử dụng get_documents với tên tài liệu từ references để tìm nạp toàn bộ nội dung tài liệu nếu cần.

Nếu bạn gặp lỗi 429 vượt quá hạn mức, hãy sử dụng search_documents.
get_documents Sử dụng công cụ này để truy xuất toàn bộ nội dung của một tài liệu hoặc tối đa 20 tài liệu trong một lệnh gọi. Bạn nên lấy tên tài liệu từ trường parent của kết quả từ lệnh gọi đến công cụ search_documents hoặc trường references do công cụ answer_query trả về. Đặt tham số names thành danh sách tên tài liệu (documents/...) và trích dẫn các tài liệu nguồn có căn cứ được dùng trong câu trả lời cuối cùng.

Lấy thông số kỹ thuật của công cụ MCP

Để lấy thông số kỹ thuật của công cụ MCP cho tất cả công cụ trong máy chủ MCP, hãy sử dụng phương thức tools/list. Ví dụ sau đây minh hoạ cách sử dụng curl để liệt kê tất cả công cụ và thông số kỹ thuật của các công cụ đó hiện có trong máy chủ MCP.

Yêu cầu Curl 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'