MCP Reference: developerknowledge.googleapis.com

Сервер Model Context Protocol (MCP) выступает в качестве прокси-сервера между внешним сервисом, который предоставляет контекст, данные или возможности большой языковой модели (LLM) или ИИ-приложению. MCP-серверы подключают ИИ-приложения к внешним системам, таким как базы данных и веб-сервисы, и преобразуют их ответы в формат, понятный ИИ-приложению.

Настройка сервера

Прежде чем использовать серверы MCP, необходимо включить их и настроить аутентификацию. Дополнительную информацию об использовании удаленных MCP-серверов Google и Google Cloud можно найти в статье Общие сведения об MCP-серверах Google Cloud.

Конечные точки сервера

Конечная точка сервиса MCP – это сетевой адрес и интерфейс связи (обычно URL) MCP-сервера, который ИИ-приложение (хост для MCP-клиента) использует для установки безопасного стандартизированного подключения. Это точка контакта, через которую LLM запрашивает контекст, вызывает инструмент или обращается к ресурсу. Конечные точки MCP Google могут быть глобальными или региональными.

У MCP-сервера Developer Knowledge API есть следующая глобальная конечная точка MCP:

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

Инструменты MCP

Инструмент MCP – это функция или исполняемый код, который MCP-сервер предоставляет LLM или ИИ-приложению для выполнения действия в реальном мире.

Инструменты

На MCP-сервере developerknowledge.googleapis.com есть следующие инструменты:

Инструменты MCP
search_documents

Этот инструмент позволяет находить документацию по продуктам Google для разработчиков. В документах содержатся официальные API, фрагменты кода, примечания к выпуску, рекомендации, руководства, сведения для отладки и многое другое. Она распространяется на следующие продукты и домены:

  • 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

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com и docs.cloud.google.com

  • Google Developers, Реклама, Поиск, Google Карты, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Платформа Google Карт: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Веб-сайт: web.dev

Этот инструмент возвращает фрагменты текста, названия и URI для соответствующих документов. Используйте search_documents, а затем get_documents, если вам нужны точные примеры кода, флаги CLI, определенные сообщения об ошибках, полные пошаговые руководства или детерминированный поиск по ключевым словам. Если возвращенные фрагменты недостаточно подробны, чтобы ответить на вопрос пользователя, используйте get_documents с parent из выходных данных этого инструмента, чтобы получить полное содержимое документа. Отвечая пользователю, всегда указывайте названия ресурсов (documents/...) или URI авторитетных исходных документов.
answer_query

Используйте answer_query, чтобы получить обоснованный источниками, синтезированный концептуальный ответ на вопрос высокого уровня о продуктах Google Developers. Если вам нужны точные примеры кода, флаги CLI, определенные сообщения об ошибках или полные пошаговые инструкции, лучше использовать search_documents, а затем get_documents. У этого инструмента ограниченная квота. Этот инструмент синтезирует информацию из корпуса, чтобы сгенерировать ответ на запрос. answer_query обосновывает ответы, используя тот же корпус, что и search_documents. Этот инструмент возвращает сгенерированный answer_text и список названий документов (ссылок), использованных для генерации ответа. В окончательном ответе пользователю всегда указывайте названия авторитетных исходных документов из references (documents/...). При необходимости используйте get_documents с названиями документов из references, чтобы получить все содержимое документа.

Если вы получаете ошибку 429, связанную с превышением квоты, используйте search_documents.
get_documents Используйте этот инструмент, чтобы получить полное содержимое одного документа или до 20 документов за один вызов. Названия документов должны быть получены из поля parent результатов вызова инструмента search_documents или поля references, возвращенного инструментом answer_query. Задайте для параметра names список названий документов (documents/...) и укажите авторитетные исходные документы, использованные в окончательном ответе.

Получение спецификаций инструмента MCP

Чтобы получить спецификации для всех инструментов на MCP-сервере, используйте метод tools/list. В примере ниже показано, как с помощью curl получить список всех инструментов и их спецификаций, доступных на MCP-сервере.

Запрос 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
}'