obot-admin-mcp

MCP-сервер, позволяющий MCP-клиенту (claude.ai, Claude Desktop и т. д.) управлять самостоятельно размещенным obot MCP-шлюзом через его REST API. Используйте его для установки, просмотра списка, проверки и удаления MCP-серверов в obot прямо из чат-клиента.

Зачем это нужно

obot предоставляет каждый зарегистрированный MCP-сервер по адресу https://<obot-host>/mcp-connect/<id>. Чтобы установить новый MCP-сервер, вы обычно обращаетесь к REST API obot или его панели администратора. Этот пакет оборачивает соответствующие эндпоинты в инструменты MCP, поэтому, как только вы зарегистрируете obot-admin-mcp в самом obot и подключите его connectURL к claude.ai, вы сможете попросить Claude «установить n8n MCP» или «показать всё, что есть в obot», и это просто заработает.

Инструменты

• list_mcp_servers — id, имя, среда выполнения, состояние конфигурации, connectURL.

• get_mcp_server(id) — полный манифест, переменные окружения, отсутствующие обязательные переменные.

• add_npx_mcp(name, package, env?, sensitiveKeys?, shortDescription?, alias?) — установка опубликованного в npm stdio MCP-сервера.

• add_remote_mcp(name, url, shortDescription?, alias?) — регистрация удаленного HTTP/SSE MCP-сервера.

• delete_mcp_server(id) — удаление MCP-сервера из obot.

• list_catalog_entries(search?) — просмотр каталога obot (по умолчанию 81 запись).

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

Две переменные окружения:

Запуск локально (Claude Desktop / разработка)

Установите напрямую из этого репозитория (публикация в npm не требуется — собранная папка dist/ уже в репозитории):

{
  "mcpServers": {
    "obot-admin": {
      "command": "npx",
      "args": ["-y", "github:kiarashedraki/obot-admin-mcp"],
      "env": {
        "OBOT_URL": "https://obot.edraki.me",
        "OBOT_TOKEN": "<your-token>"
      }
    }
  }
}

Регистрация внутри obot (мета-цикл)

curl -X POST https://obot.edraki.me/api/mcp-servers \
  -H "Authorization: Bearer $OBOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": {
      "name": "obot-admin",
      "shortDescription": "Manage obot itself",
      "runtime": "npx",
      "npxConfig": { "package": "obot-admin-mcp" },
      "env": [
        { "key": "OBOT_URL",   "value": "https://obot.edraki.me", "required": true,  "sensitive": false },
        { "key": "OBOT_TOKEN", "value": "<token>",                "required": true,  "sensitive": true  }
      ]
    },
    "alias": "obot-admin"
  }'

Ответ включает connectURL — вставьте его в claude.ai → Settings → Connectors → Add custom connector.

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

Токен начальной загрузки/администратора дает полный контроль над obot, который монтирует сокет docker хоста. Относитесь к этому токену как к учетным данным root. Не регистрируйте obot-admin-mcp на общем/мультиарендном obot без дополнительной защиты (например, Cloudflare Access перед obot-connect/<id>).

Лицензия

MIT