mcp-adapter

TL;DR: MCP Adapter позволяет вашему AI-агенту подключаться к любому серверу, поддерживающему Model Context Protocol (MCP), и получать доступ к инструментам и данным без необходимости писать отдельные интеграции.

Обзор

mcp-adapter — это навык для OpenClaw, который использует MCP-серверы для работы с внешними инструментами и источниками данных. С его помощью агент может находить и выполнять инструменты, предоставленные подключёнными MCP-серверами: от юридических баз до API, баз данных и сервисов погоды. :

Плагин реализует транспорт MCP (Streamable HTTP) и предоставляет единый интерфейс для вызова внешних инструментов. Это позволяет расширять возможности AI-агентов без сложной настройки интеграций. :

Ключевые возможности

• Поддержка HTTP/SSE транспорта для MCP
• Автоматическое обнаружение доступных инструментов
• Подключение нескольких MCP-серверов одновременно
• Единый интерфейс через инструмент mcp
• Обработка ошибок и логирование

Основные сценарии использования

• Подключение агента к внутренним MCP-серверам компании
• Объединение нескольких серверов в один рабочий процесс
• Тестирование и отладка MCP-серверов
• Добавление новых инструментов без переписывания интеграции

Установка

Самый простой способ — установить навык через OpenClaw:

npx clawhub@latest install mcp-adapter

Также доступна установка вручную через клонирование репозитория и подключение к системе расширений OpenClaw. :

Конфигурация

После установки необходимо добавить конфигурацию MCP-серверов в файл настроек OpenClaw:

{
 "plugins": {
 "entries": {
 "mcp-integration": {
 "enabled": true,
 "config": {
 "enabled": true,
 "servers": {
 "example-server": {
 "enabled": true,
 "transport": "http",
 "url": "http://localhost:3000/mcp"
 }
 }
 }
 }
 }
 }
}

Можно подключать несколько серверов одновременно, расширяя набор доступных инструментов для агента. :

Как это работает

Плагин предоставляет единый инструмент mcp с двумя основными действиями:

• list — получить список доступных инструментов
• call — вызвать конкретный инструмент с параметрами

Этап 1: Обнаружение инструментов

Рекомендуется начинать с получения списка доступных инструментов:

{
 tool: "mcp",
 args: {
 action: "list"
 }
}

Ответ содержит список инструментов, их описание и схему входных параметров. :

Этап 2: Вызов инструмента

После выбора инструмента формируется запрос с параметрами:

{
 tool: "mcp",
 args: {
 action: "call",
 server: "",
 tool: "",
 args: {
 // параметры
 }
 }
}

Перед вызовом важно проверить обязательные параметры и соответствие типам данных.

Этап 3: Многошаговые сценарии

Для сложных задач можно выстраивать цепочки вызовов:

• Поиск данных
• Получение полной информации
• Анализ результатов
• Дополнительные запросы

Каждый следующий шаг использует результат предыдущего, формируя полноценный workflow. :

Безопасность

Плагин обладает стандартными сетевыми правами для взаимодействия с серверами, поэтому важно подключаться только к доверенным источникам и внимательно относиться к настройке конфигурации и секретов. :

Итог

mcp-adapter — это универсальный мост между AI-агентом и внешними инструментами. Он позволяет быстро расширять функциональность без сложной разработки, объединяя разные источники данных в единую систему взаимодействия.