Servidor de búsqueda MCP de Powertools

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona funcionalidad de búsqueda para la documentación de AWS Lambda Powertools en múltiples tiempos de ejecución.

Guía de inicio rápido de Claude Desktop

Siga las instrucciones de instalación. Consulte la Guía de inicio rápido del Protocolo de Contexto de Modelo para usuarios de Claude Desktop . Deberá agregar una sección al archivo de configuración de MCP como se indica a continuación:

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

Related MCP server: MCP-Ragdocs

Descripción general

Este proyecto implementa un servidor MCP que permite a los Modelos de Lenguaje Grandes (LLM) buscar en la documentación de AWS Lambda Powertools. Utiliza lunr.js para lograr una búsqueda local eficiente y proporciona resultados que se pueden resumir y presentar a los usuarios.

Características

• Servidor compatible con MCP para integración con LLM

• Búsqueda local utilizando índices de lunr.js

• Soporte para múltiples tiempos de ejecución:

  • Pitón

  • Mecanografiado

  • Java

  • .NETO

• Búsqueda de documentación específica de la versión (predeterminada a la más reciente)

Instalación

# Install dependencies
pnpm install

# Build the project
pnpm build

Uso

El servidor se puede ejecutar como un servidor MCP que se comunica a través de stdio:

npx -y @serverless-dna/powertools-mcp

Herramienta de búsqueda

El servidor proporciona una herramienta search_docs con los siguientes parámetros:

• search : La cadena de consulta de búsqueda

• runtime : El tiempo de ejecución de Powertools para buscar (Python, TypeScript, Java, DotNet)

• version : cadena de versión opcional (predeterminada en 'última')

Desarrollo

Estructura del proyecto

• src/ : Código fuente

  • index.ts : Implementación del servidor principal

  • searchIndex.ts : Gestión de índices de búsqueda

• indexes/ : Índices de búsqueda de lunr.js preconstruidos para cada entorno de ejecución

• dist/ : Salida compilada

Edificio

pnpm build

Pruebas

pnpm test

Configuración de MCP de Claude Desktop

Durante el desarrollo, puede ejecutar el servidor MCP con Claude Desktop utilizando la siguiente configuración.

La siguiente configuración se ejecuta en el escritorio de Windows Claude mientras se desarrolla con el Subsistema de Windows para Linux (WSL). En entornos Mac o Linux, la ejecución es similar.

La salida es un archivo incluido que permite que Node instalado en Windows ejecute el servidor MCP ya que todas las dependencias están incluidas.

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

Cómo funciona

1. El servidor carga índices lunr.js prediseñados para cada entorno de ejecución compatible

2. Cuando se recibe una solicitud de búsqueda, se realiza lo siguiente:

   • Carga el índice apropiado según el tiempo de ejecución y la versión (actualmente fijada a la más reciente)

   • Realiza la búsqueda utilizando lunr.js

   • Devuelve los resultados de la búsqueda como JSON

3. El LLM puede luego utilizar estos resultados para encontrar páginas de documentación relevantes.

Licencia

Instituto Tecnológico de Massachusetts (MIT)