agent-ready-mcp

agent-ready-mcp

mlavaMIT
1 звёзд
Agent Ready MCP проверяет, насколько сайт готов к взаимодействию с AI-агентами. Вы передаёте URL, сервер запускает 60 тестов по трём семействам стандартов: спецификации Vercel Agent Readability, стандарту llmstxt.org и протоколам агентов (MCP, A2A, agents.json). Сервер сверяется со спецификацией Vercel (15 общесайтовых тегов и 23 постраничных правила), стандартом llmstxt.org (LLMs.txt, LLMs-full.txt, robots.txt) и протоколами агентов (MCP Server Cards, A2A, agents.json, agent-permissions.json, NLWeb, x402, UCP). Результат — точная оценка и пошаговая инструкция по исправлению. Это единственный публичный MCP-сервер, объединяющий все три семейства AI-стандартов в одном инструменте. Вы работаете с ним через AI-ассистента, а не через веб-интерфейс.
Ai-mlSecurityVercel
Открыть на GitHub

Установка

npx -y agent-ready-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикmlava
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Сканирует любой URL на читаемость для AI-агентов по 60 критериям.
  • Выполняет 38 проверок по спецификации Vercel Agent Readability (15 общесайтовых + 23 постраничных).
  • Анализирует 10 критериев стандарта llmstxt.org: наличие LLMs.txt, LLMs-full.txt, индексацию в robots.txt.
  • Проверяет 12 протоколов агентов: MCP Server Cards, A2A, agents.json, agent-permissions.json, x402, NLWeb, UCP.
  • Для каждого проваленного теста выводит конкретную инструкцию по исправлению.
  • Рассчитывает итоговую оценку готовности сайта (score) по каждому стандарту.
  • Ищет информацию по методологии Agent Ready через текстовый инструмент ask без API-ключа.
  • Сохраняет результаты сканирования и отдаёт их по ID через get_scan.
  • Включает три встроенных промпта: scan, interpret_scan, remediation_plan — для полного цикла от URL до плана рефакторинга.
  • Опрашивает API до 60 секунд (таймаут настраивается через переменную окружения AGENT_READY_SCAN_TIMEOUT_MS).

Как подключить

1. Установите пакет через npx:

npx -y agent-ready-mcp@latest

2. Получите Pro-тариф и API-ключ на сайте Agent Ready.

3. Добавьте конфигурацию для Claude Desktop (macOS / Windows):

{ "mcpServers": { "agent-ready": { "command": "npx", "args": ["-y", "agent-ready-mcp@latest"], "env": { "AGENT_READY_API_KEY": "ar_live_..." } } } }

Для Cursor или VS Code укажите тот же JSON в файлах .cursor/mcp.json или .vscode/mcp.json. Для Windsurf — в ~/.codeium/windsurf/mcp_config.json. Для Claude Code выполните:

claude mcp add agent-ready -e AGENT_READY_API_KEY=ar_live_... -- npx -y agent-ready-mcp@latest

4. Перезапустите MCP-клиент.

5. (Опционально) Настройте переменные: AGENT_READY_API_URL для кастомного сервера, AGENT_READY_SCAN_TIMEOUT_MS и AGENT_READY_GET_TIMEOUT_MS для таймаутов.

Примеры запросов

  • «Проверь сайт mysite.com на готовность к AI-агентам. Выведи общую оценку и список критических ошибок.»
  • «Покажи полный отчёт по скану scan_abc123.»
  • «Создай пошаговый план рефакторинга для vercel.com на основе последнего скана.»
  • «Найди в документации Agent Ready, что такое NLWeb и как его внедрить.»
  • «Объясни, чем отличается llmstxt.org от Vercel Agent Readability Spec.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio (обёртка над Streamable HTTP API)
  • Лицензия: MIT
  • Требуется API-ключ Pro-тарифа
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf

Поделиться