Поисковый сервер Powertools MCP

Сервер протокола контекста модели (MCP), который обеспечивает функцию поиска по документации AWS Lambda Powertools в различных средах выполнения.

Краткое руководство по работе с Claude Desktop

Следуйте инструкциям по установке, пожалуйста, следуйте краткому руководству Model Context Protocol для пользователей Claude Desktop . Вам нужно будет добавить раздел в файл конфигурации MCP следующим образом:

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": [
        "-y",
        "@serverless-dna/powertools-mcp"
      ]
    }
  }
}

Related MCP server: MCP-Ragdocs

Обзор

Этот проект реализует сервер MCP, который позволяет Large Language Models (LLM) выполнять поиск по документации AWS Lambda Powertools. Он использует lunr.js для эффективных возможностей локального поиска и предоставляет результаты, которые можно суммировать и представлять пользователям.

Функции

• MCP-совместимый сервер для интеграции с LLM

• Локальный поиск с использованием индексов lunr.js

• Поддержка нескольких сред выполнения:

  • Питон

  • Машинопись

  • Ява

  • .СЕТЬ

• Поиск документации по конкретной версии (по умолчанию последняя версия)

Установка

# Install dependencies
pnpm install

# Build the project
pnpm build

Использование

Сервер может быть запущен как сервер MCP, взаимодействующий через stdio:

npx -y @serverless-dna/powertools-mcp

Инструмент поиска

Сервер предоставляет инструмент search_docs со следующими параметрами:

• search : строка поискового запроса

• runtime : среда выполнения Powertools для поиска (python, typescript, java, dotnet)

• version : Необязательная строка версии (по умолчанию «последняя»)

Разработка

Структура проекта

• src/ : Исходный код

  • index.ts : Реализация основного сервера

  • searchIndex.ts : Управление индексом поиска

• indexes/ : Готовые поисковые индексы lunr.js для каждой среды выполнения

• dist/ : Скомпилированный вывод

Здание

pnpm build

Тестирование

pnpm test

Конфигурация MCP рабочего стола Клода

Во время разработки вы можете запустить MCP Server с Claude Desktop, используя следующую конфигурацию.

Конфигурация ниже показывает запуск в Windows Claude Desktop при разработке с использованием Windows Subsystem for Linux (WSL). Среды Mac или Linux можно запустить аналогичным образом.

На выходе получается связанный файл, который позволяет Node, установленному в Windows, запускать сервер MCP, поскольку все зависимости связаны.

{
  "mcpServers": {
    "powertools": {
	"command": "node",
	"args": [
	  "\\\\wsl$\\Ubuntu\\home\\walmsles\\dev\\serverless-dna\\powertools-mcp\\dist\\bundle.js"
	]
    }
  }
}

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

1. Сервер загружает предварительно созданные индексы lunr.js для каждой поддерживаемой среды выполнения.

2. При получении поискового запроса он:

   • Загружает соответствующий индекс на основе времени выполнения и версии (в настоящее время установлена последняя версия)

   • Выполняет поиск с использованием lunr.js

   • Возвращает результаты поиска в формате JSON

3. Затем LLM может использовать эти результаты для поиска соответствующих страниц документации.

Лицензия

Массачусетский технологический институт