AWS Lambda Powertools Documentation Search

🚀 AWS Lambda Powertools MCP 搜索服务器

本项目是一个基于 Model Context Protocol (MCP) 的服务，专为大型语言模型 (LLMs) 提供多运行时 AWS Lambda Powertools 文档的搜索功能，能高效检索并呈现相关文档内容，助力用户快速获取所需信息。

🚀 快速开始

Claude Desktop 快速启动

若你使用 Claude Desktop，可按照 Claude Desktop 用户的 Model Context Protocol 快速开始指南 进行安装。你需要在 MCP 配置文件中添加如下内容：

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

✨ 主要特性

• 符合 MCP 标准：该服务器严格遵循 MCP 标准，可与大型语言模型 (LLMs) 实现无缝集成。
• 高效本地搜索：借助 lunr.js 索引，实现高效的本地文档搜索。
• 多运行时支持：支持 Python、TypeScript、Java 和 .NET 等多种运行时环境。
• 版本特定搜索：支持按版本搜索文档，默认搜索最新版本。

📦 安装指南

# 安装依赖项
pnpm install

# 构建项目
pnpm build

💻 使用示例

基础用法

该服务器可作为 MCP 服务运行，通过 stdio 进行通信：

npx -y @serverless-dna/powertools-mcp

高级用法

服务器提供了 search_docs 工具，可使用以下参数进行搜索：

• search: 搜索查询字符串
• runtime: Powertools 的运行时（python、typescript、java、dotnet）
• version: 可选版本号（默认为 'latest'）

📚 详细文档

项目结构

• src/：源代码目录
  • index.ts：主服务器实现文件
  • searchIndex.ts：搜索索引管理文件
• indexes/：存放每个运行时的预建 lunr.js 搜索索引
• dist/：编译输出目录

构建

pnpm build

测试

pnpm test

Claude Desktop MCP 配置

在开发期间，你可以使用以下配置在 Claude Desktop 上运行 MCP 服务器。以下示例展示了在 Windows 系统上使用 WSL（Windows Subsystem for Linux）进行开发的情况，Mac 或 Linux 环境可参照操作。输出是一个捆绑文件，可启用 Windows 中安装的 Node 来运行 MCP 服务器，因为所有依赖项都已打包。

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

🔧 技术细节

1. 服务器会加载每个支持运行时的预建 lunr.js 索引。
2. 当收到搜索请求时，服务器会根据运行时和版本（当前固定为 latest）加载适当的索引，使用 lunr.js 进行搜索，并以 JSON 格式返回搜索结果。
3. 大型语言模型 (LLMs) 可利用这些结果查找相关文档页面。

📄 许可证

本项目采用 MIT 许可证。