项目简介

Powertools for AWS 文档上下文协议 (MCP) 服务器是一个基于 Model Context Protocol (MCP) 的实现,专注于为大型语言模型 (LLM) 代理提供AWS Powertools for AWS Lambda文档的搜索和访问能力。它允许LLM代理直接在其上下文中查找与Powertools相关的文档和代码示例,从而更快地获取所需信息,提高开发效率。

主要功能点

  • 文档搜索: 允许LLM代理通过关键词搜索AWS Powertools文档,查找特定主题或功能的介绍。
  • 页面获取: 能够根据URL获取具体的文档页面内容,以便LLM代理深入阅读和理解。
  • 多运行时支持: 支持对 Python, TypeScript, Java, .NET 等多种AWS Lambda Powertools运行时的文档进行搜索和获取。
  • 版本控制: 支持按文档版本(如 "latest" 或特定语义版本号)进行查询,确保获取信息的准确性。
  • 智能缓存: 内置缓存机制,通过 ETag 验证,优化文档获取速度,减少重复网络请求。

安装步骤

  1. 准备环境: 确保您的系统已安装 Node.js (建议 v24 及以上版本) 和 npm/npx。
  2. 启动服务器: 在命令行中执行以下命令,使用 npx 运行 MCP 服务器:
    npx -y powertools-for-aws-mcp
    服务器将会在后台启动并通过标准输入输出 (STDIO) 与您的 MCP 客户端通信。'npx -y' 会自动下载并运行该包。

服务器配置

您的 MCP 客户端(例如 Cursor, VS Code, Amazon Q Developer CLI, Kiro, Windsurf, Claude Code 等)需要配置以下 JSON 对象才能连接到此 MCP 服务器。以下是一个典型的配置示例:

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

配置信息说明:

  • 'mcpServers': 这是 MCP 客户端配置所有 MCP 服务器的顶级键。
  • 'powertools': 这是您为此 MCP 服务器定义的名称(例如,在本例中为 "powertools")。您可以自定义此名称,但建议使用易于识别的名称。
  • 'command': 指定用于启动 MCP 服务器进程的命令。对于此服务器,通常是 'npx'。
  • 'args': 一个字符串数组,包含传递给 'command' 的参数。
    • '"-y"': 表示在安装或运行 npm 包时自动确认所有提示。
    • '"powertools-for-aws-mcp"': 这是此 MCP 服务器的 npm 包名称,'npx' 将会找到并运行它。

根据您使用的 MCP 客户端,上述配置可能需要放置在特定的全局或项目级别配置文件中(例如 '~/.cursor/mcp.json' 或 '.vscode/mcp.json')。详情请参考您客户端的官方文档。

基本使用方法

配置完成后,您可以在支持 MCP 协议的 LLM 客户端(如集成开发环境中的 AI 助手)中,通过自然语言指令来调用此服务器提供的功能。例如:

  • 搜索文档: 向您的 AI 助手提问:"使用 Powertools MCP 服务器,搜索关于 Python Logger 的文档。" (AI 助手会自动调用 'search_docs' 工具,并将搜索结果呈现给您)

  • 获取页面: 向您的 AI 助手提问:"从 Powertools MCP 服务器获取 'https://docs.aws.amazon.com/powertools/typescript/latest/features/metrics/' 页面内容。" (AI 助手会自动调用 'fetch_doc_page' 工具,并将该页面的详细内容纳入其上下文,以供进一步分析或回答您的问题)

AI 助手会根据您的指令,自动调用相应的工具,并将获取到的文档信息纳入其上下文,以更好地回答您关于 AWS Powertools 的问题。

信息

分类

开发者工具