AWS MCP 的 Powertools

AWS 模型上下文协议 (MCP) 的 Powertools 是一个实现，它提供了跨多个运行时搜索 AWS Lambda 文档的功能。它允许您的大语言模型 (LLM) 代理搜索与工具包相关的文档和示例，帮助您快速找到所需的信息，以便有效地使用 AWS Lambda 的 Powertools。

[!WARNING] 此项目是实验性的，并且正在积极开发中。 API 和功能可能会频繁更改而不另行通知。

💡 参与进来

我们正积极寻求社区反馈和功能建议，请加入我们的 Discord 或 打开一个议题，分享您的想法。

使用场景

• 将文档和示例直接带入您的 LLM 代理的上下文中。
• 在 AWS Powertools 文档中搜索特定主题或关键词。
• 帮助您的代理理解如何有效地使用 AWS Lambda 的 Powertools 工具包。

快速开始

Cursor	VS Code

大多数支持 MCP 的客户端都可以使用类似以下配置直接使用此服务器：

[!NOTE] 如果您使用的是较旧版本的 MCP，请确保更新您的配置以使用新的包名 powertools-for-aws-mcp。

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

此设置使用 Node.js 包管理器来本地运行 MCP 服务器，并通过 STDIO 接口与其通信。

客户端特定设置说明

对于特定客户端的详细设置说明，请参阅以下配置：

使用 Amazon Q 开发者 CLI 快速开始

<details> <summary>在 Amazon Q 开发者 CLI 中使用</summary>

请参阅 Amazon Q 开发者 CLI 文档 了解详情。

使用 CLI 命令添加 MCP 服务器：

qchat mcp add --name powertools --command "npx -y powertools-for-aws-mcp"

手动配置： 如果您选择全局作用域，MCP 服务器配置将存储在 ~/.aws/amazonq/mcp.json 并在所有项目中可用。如果您选择局部作用域，配置将存储在当前项目的 .amazonq/mcp.json 内。

~/.aws/amazonq/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

</details>

使用 Kiro 快速开始

<details> <summary>在 Kiro 中使用</summary>

请参阅 Kiro 模型上下文协议文档 了解详情。

1. 导航到 Kiro > MCP 服务器
2. 通过选择 + 添加 按钮添加一个新的 MCP 服务器。
3. 粘贴下面给出的配置：

kiro_mcp_settings.json

对于 macOS/Linux：

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

对于 Windows：

{
  "mcpServers": {
    "powertools": {
      "disabled": false,
      "timeout": 120,
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

</details>

使用 Cursor 快速开始

<details> <summary>使用 Cursor 快速开始</summary>

1. 根据您的使用情况，您可以将 MCP 配置放置在两个位置之一：

A. 项目配置 - 对于特定于项目的工具，在项目目录中创建一个 .cursor/mcp.json 文件。这允许您定义仅在该特定项目中可用的 MCP 服务器。

B. 全局配置 - 对于您希望在所有项目中使用的工具，在您的主目录中创建一个 ~/.cursor/mcp.json 文件。这使 MCP 服务器在所有 Cursor 工作区中都可用。

.cursor/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

2. 在聊天中使用 MCP：Composer Agent 将自动使用 MCP 设置页面下“可用工具”部分列出的任何 MCP 工具，如果它认为这些工具相关。要有意提示工具使用，请提示 Cursor 使用您希望使用的 MCP 服务器。例如，“使用 Powertools MCP 服务器，做...”

3. 工具审批：默认情况下，当代理想要使用 MCP 工具时，它会显示一条消息请求您的批准。您可以使用工具名称旁边的箭头展开消息，查看代理调用工具时传递的参数。

</details>

使用 Windsurf 快速开始

<details> <summary>使用 Windsurf 快速开始</summary>

1. 访问 MCP 设置

   • 导航到 Windsurf - 设置 > 高级设置 或使用命令面板 > 打开 Windsurf 设置页面
   • 查找“模型上下文协议 (MCP) 服务器”部分

2. 添加 MCP 服务器

   • 选择“添加服务器”以添加新的 MCP 服务器
   • 您可以从 GitHub、Puppeteer、PostgreSQL 等可用模板中选择
   • 或者选择“添加自定义服务器”来配置自己的服务器

3. 手动配置

   • 您还可以手动编辑位于 ~/.codeium/windsurf/mcp_config.json 的 MCP 配置文件

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

</details>

使用 VS Code 快速开始

<details> <summary>在 VS Code 中安装</summary>

在 VS Code 设置中配置 MCP 服务器或在 .vscode/mcp.json 中配置（更多信息请参阅 VS Code MCP 文档）：

.vscode/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

</details>

使用 Claude Code 快速开始

<details> <summary>在 Claude Code 中使用</summary>

使用 CLI 命令添加 MCP 服务器：

claude mcp add powertools

手动配置（推荐）： 您可以直接编辑位于 ~/.claude.json 的配置文件。这种方法更灵活，允许您一次性看到所有配置。

~/.claude.json

{
  "mcpServers": {
    "powertools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

重启 Claude Code： 编辑完配置文件后，重启 Claude Code 以使更改生效。

</details>

开发

克隆仓库后，可以通过运行以下命令设置开发环境：

npm ci
npm run setup:hooks

之后，您可以使用 npm t 运行测试，或者使用 npm run test:unit:coverage 获取覆盖率报告。

您也可以使用以下命令本地运行服务器：npm run dev，这将启动一个调试服务器，让您能够通过浏览器界面与 MCP 服务器交互。

如果您愿意，还可以配置服务器与 Amazon Q、Claude Desktop 或其他支持模型上下文协议 (MCP) 的 LLM 客户端一起运行，使用 node 作为命令并传递 --experimental-transform-types 标志以及此项目的 src/index.ts 文件路径。

例如，对于 Claude Code，您可以通过运行以下命令添加服务器：

claude mcp add pt-dev node -- --experimental-transform-types /path/to/project/powertools-mcp/src/index.ts

致谢

感谢 Michael Walmsley 在 ServerlessDNA.com 创建了此 MCP 服务器的初始实现，并将其捐赠给 Amazon Web Services 的 AWS Powertools 团队。

许可证

本库根据 MIT 许可证发布。请参阅 LICENSE 文件。