What is Powertools Mcp

Powertools MCP is a Model Context Protocol (MCP) server designed to provide search functionality for AWS Lambda Powertools documentation across multiple programming runtimes.

Use cases

Use cases include searching for specific AWS Lambda Powertools documentation across different programming languages, assisting developers in quickly finding relevant information, and enhancing the development workflow by integrating search functionalities into applications.

How to use

To use Powertools MCP, install the dependencies using ‘pnpm install’, build the project with ‘pnpm build’, and run the server using ‘npx -y @serverless-dna/powertools-mcp’. You can perform searches using the ‘search_docs’ tool with parameters for query string, runtime, and version.

Key features

Key features include compliance with MCP for integration with Large Language Models (LLMs), local search capabilities using lunr.js, support for multiple runtimes (Python, TypeScript, Java, .NET), and version-specific documentation search.

Where to use

Powertools MCP can be used in software development environments where AWS Lambda Powertools documentation needs to be accessed and searched efficiently, particularly in projects utilizing LLMs.

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.