项目简介

这是一个示例项目,展示如何构建一个符合 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) 作为通信协议。

安装步骤

  1. 确保您已安装 Git、Java 21 或更高版本。
  2. 配置 AWS 凭证,确保您的环境中有有效的 AWS Profile,并具备访问 SES v2 的权限。
  3. 克隆仓库:'git clone https://github.com/aws-samples/sample-for-amazon-ses-mcp.git'
  4. 进入项目目录:'cd sample-for-amazon-ses-mcp'
  5. 构建项目:在 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与计算