powertools-for-aws-mcp

Powertools for AWS MCP

The Powertools for AWS Model Context Protocol (MCP) is an MCP implementation that provides search functionality for the Powertools for AWS Lambda documentation across multiple runtimes. It allows your LLM agents to search for documentation and examples related to the toolkit, helping you to quickly find the information you need to use Powertools for AWS Lambda effectively.

[!WARNING] This project is experimental and under active development. APIs and features may change frequently without notice.

💡 Get Involved

We're actively seeking community feedback and feature suggestions join our Discord or open an issue to share your thoughts.

Use Cases

• Bring documentation and examples directly into your LLM agents' context.
• Search for specific topics or keywords within the Powertools for AWS documentation.
• Help your agents understand how to use the Powertools for AWS Lambda toolkit effectively.

Getting Started

Most clients that support MCP can use this server out of the box using a configuration similar to the following:

[!NOTE] If you are using an older version of the MCP, make sure to update your configuration to use the new package name powertools-for-aws-mcp.

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

This setup uses the Node.js package manager to run the MCP server locally and communicate with it using the STDIO interface.

Development

After cloning the repository, you can set up your development environment by running:

npm ci
npm run setup:hooks

After that you can run tests using npm t or npm run test:unit:coverage for coverage reports.

You can also run the server locally using: npm run dev, this will start an inspector server that lets you interact with the MCP server using a browser UI.

If you want, you can also configure the server to run with Amazon Q, Claude Desktop, or other LLM clients that support the Model Context Protocol (MCP) by using node as command and passing the --experimental-transform-types flag and the path to the src/index.ts file of this project.

For example, with Claude Code, you can add the server by running:

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

Credits

Michael Walmsley at ServerlessDNA.com for creating the initial implementation of this MCP server and donating it to the Powertools for AWS team at Amazon Web Services.

License

This library is licensed under the MIT License. See the LICENSE file.

Changelog

v0.8.8

compare changes

🩹 Fixes

• Add Nodejs shebang to module entry point (#122)

🏡 Chore

• deps-dev: Bump @modelcontextprotocol/inspector from 0.14.0 to 0.14.1 in the npm_and_yarn group across 1 directory (#95)
• deps-dev: Bump @modelcontextprotocol/inspector from 0.14.0 to 0.14.2 (#97)
• deps-dev: Bump lint-staged from 16.1.0 to 16.1.2 (#98)
• Upgrade to biome 2.x (#103)
• deps-dev: Bump the vitest group across 1 directory with 2 update (#104)
• deps-dev: Bump @biomejs/biome from 2.0.0 to 2.0.6 (#113)
• deps-dev: Bump @modelcontextprotocol/inspector from 0.14.2 to 0.15.0 (#117)