项目简介
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 验证,优化文档获取速度,减少重复网络请求。
安装步骤
- 准备环境: 确保您的系统已安装 Node.js (建议 v24 及以上版本) 和 npm/npx。
- 启动服务器: 在命令行中执行以下命令,使用 npx 运行 MCP 服务器:
服务器将会在后台启动并通过标准输入输出 (STDIO) 与您的 MCP 客户端通信。'npx -y' 会自动下载并运行该包。npx -y powertools-for-aws-mcp
服务器配置
您的 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 的问题。
信息
分类
开发者工具