项目简介
这是一个示例项目,展示如何构建一个符合 Model Context Protocol (MCP) 标准的服务器,用于集成 Amazon Simple Email Service (SES) v2。通过此服务器,支持 MCP 的 LLM 客户端(如 Amazon Q Developer CLI 或 Claude Desktop)可以访问 SES 的各种功能,如发送邮件、管理联系人等。
主要功能点
- 通过 MCP 协议暴露 Amazon SES v2 的全部公共 API 操作。
- 允许 LLM 客户端调用 SES 功能,例如发送简单或使用模板的电子邮件、管理 IP 地址池、检查送达率、管理联系人列表和阻止列表等。
- 实现 MCP 服务器端逻辑,处理客户端请求。
- 使用标准输入/输出 (Stdio) 作为通信协议。
安装步骤
- 确保您已安装 Git、Java 21 或更高版本。
- 配置 AWS 凭证,确保您的环境中有有效的 AWS Profile,并具备访问 SES v2 的权限。
- 克隆仓库:'git clone https://github.com/aws-samples/sample-for-amazon-ses-mcp.git'
- 进入项目目录:'cd sample-for-amazon-ses-mcp'
- 构建项目:在 macOS/Linux 上运行 './build.sh',在 Windows 上运行 '.\build.bat'。构建成功后,脚本会输出生成的 JAR 文件路径。
服务器配置
将以下配置信息添加到您的 MCP 客户端的配置文件中(例如 Amazon Q Developer CLI 或 Claude Desktop 的配置文件)。请将 'JAR_PATH_FROM_BUILD_OUTPUT' 替换为构建步骤中输出的 JAR 文件实际路径。
{ "mcpServers": { "sesv2-mcp-server": { // 服务器名称,客户端用此名称引用此服务器 "command": "java", // 启动服务器的可执行命令 "args": [ // 传递给命令的参数 "-jar", "JAR_PATH_FROM_BUILD_OUTPUT" // 构建生成的 JAR 文件路径 ] } } }
基本使用方法
成功配置服务器后,启动支持 MCP 的 LLM 客户端。客户端将自动连接到配置的 MCP 服务器。您可以通过客户端与 LLM 进行交互,并提示 LLM 使用此服务器提供的功能来执行 SES 相关的任务,例如让 LLM 帮助您起草并发送一封邮件。
信息
分类
AI与计算