aws-knowledge-plus

Kiro Power для источников знаний AWS, которые не индексирует официальный AWS Knowledge MCP Server.

Почему он существует

Официальный сервер бесплатен, не требует аутентификации, поддерживается AWS и уже охватывает документацию AWS, блоги AWS, What's New, Well-Architected и статьи re:Post Knowledge Center. Перестраивать всё это означало бы собирать данные с недокументированных эндпоинтов ради контента, который уже доступен через поддерживаемый интерфейс.

Поэтому этот Power покрывает только то, что официальный сервер не обрабатывает. Границу определяет allow-list read_documentation:

Related MCP server: NexusNote MCP Server

Предварительные требования

• uv в PATH (даёт uvx). Power не требует собственного Python: uv сам загрузит интерпретатор.

• Официальный AWS Knowledge MCP Server — для всего, что в строках «Покрывается» выше. Этот Power намеренно не указывает его в своих зависимостях: клиенты, у которых он уже есть, не будут открывать второе подключение к тому же эндпоинту и загружать дублирующий набор инструментов. Если у вас его ещё нет, добавьте в ~/.kiro/settings/mcp.json:

  {
    "mcpServers": {
      "aws-knowledge": {
        "url": "https://knowledge-mcp.global.api.aws"
      }
    }
  }

Установка

Из GitHub (рекомендуется для команд)

1. Kiro → панель Powers → Add Custom Power → Import power from GitHub

2. Вставьте URL этого репозитория

Из локального клона

1. git clone https://github.com/owner/my-project

2. Kiro → панель Powers → Add Custom Power → Import power from a folder

3. Выберите склонированную папку

Без панели Powers — добавьте сервер напрямую в ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "aws-knowledge-plus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hey-iam-ryan/kiro-power-aws-knowledge-plus@v0.1.0",
        "aws-knowledge-plus-mcp"
      ],
      "autoApprove": ["search_aws_knowledge", "read_aws_content", "list_sources"]
    }
  }
}

Первый запуск разрешает дерево зависимостей и занимает несколько секунд; последующие запуски кэшируются uv.

Использование этого Power в команде

Этот Power доступен только для чтения всем, кроме мейнтейнера. В публичном GitHub-репозитории могут делать push только те аккаунты, которые явно добавлены в коллабораторы, а таких нет. Клонирование, установка и создание форков не дают возможности изменить то, что устанавливают ваши коллеги.

Установки привязаны к тегу релиза, а не к main. Ссылка в mcp.json указывает на @v0.1.0, поэтому каждый участник команды запускает один и тот же проверенный код, даже если main уже ушёл вперёд. Никто не получает обновления молча.

Нужны изменения? Создайте issue или pull request. Мейнтейнер проверяет его, вливает и срезает новый тег; участники получат версию после обновления привязки.

Выпуск новой версии, для мейнтейнера:

# after merging changes to main
uv run python smoke_test.py            # must pass: it hits the live sources
git tag v0.2.0 && git push origin v0.2.0
# then bump the @v0.1.0 pin in mcp.json and README.md, commit, and push

Инструменты

Фрагменты поиска намеренно короткие: они нужны, чтобы выбрать, что читать, а не чтобы отвечать на вопрос.

Как выглядит чтение

• re:Post — восстанавливается из структурированных данных schema.org QAPage ветки: вы получаете вопрос и все ответы с авторами, датами, голосами и пометкой принятого ответа. Без HTML-скрапинга, а блоки кода сохраняются целиком.

• docs.kiro.dev — страница запрашивается со своей опубликованной markdown-версии (/docs/steering читает /docs/steering.md), поэтому снимать навигацию с сайта не приходится.

• Builder Center — только сохранная из Atom-фида, с явным примечанием, что текст статьи не извлекался.

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

Известные ограничения

• Builder Center структурно ограничен. Его единственный публичный индекс — Atom-лента на 30 записей, у которой ссылка next зациклена сама на себя, поэтому более старые записи не находятся. Страницы статей рендерятся на клиенте и не запрашиаяются. Поэтому этот источник имеет низкий вес и его можно отключить.

• Глубина поиска на re:Post. Сайт учитывает pageSize, но не page, поэтому результаты приходят с одной увеличенной страницы, а не через глубокую пагинацию.

• Недокументированные эндпоинты. Выдача поиска re:Post берётся из встроенного в страницу payload __NEXT_DATA__. Это не публичный API, и он может измениться. Адаптер поддерживает оба варианта payload, которые сайт сейчас отдаёт отдельных и выдаёт пустой результат вместо падения, если не находит ни одного, но редизайн сайта потребует доработки.

Разработка

uv sync
uv run python smoke_test.py     # live checks against all three sources
uv run aws-knowledge-plus-mcp   # start on stdio

smoothing_test.py ходит на реальные сайты, поэтому работает и как индикатор: если источник изменит разметку или payload, он первым упадёт здесь.

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

Исходящие запросы ограничены списком разрешённых хостов и префиксов путей — аallow-list строится из объявленных в каждом адаптере хостов и префиксов. Редиректы обрабатываются по одному переходу за раз, и каждый переход испенняется заново, поэтому редирект не может увести загрузчик на хост, которого нет в списке. Принимается только https. Запросы не содержат учётных данных, а все источники публичные.

Лицензия

Apache-2.0