项目简介

本项目 'mcp-server-acsemail' 是一个基于 Model Context Protocol (MCP) 构建的服务器，专注于提供邮件发送服务。它利用 Azure Communication Services (ACS) 作为邮件后端，允许LLM客户端通过调用预设的工具，实现程序化的邮件发送功能。

主要功能点

• 邮件发送工具: 提供多种邮件发送工具，包括：
  • 发送单封邮件: 支持向单个收件人发送邮件。
  • 发送带附件邮件: 支持发送带有附件的邮件。
  • 批量发送邮件: 支持向多个收件人批量发送邮件。
• 配置信息资源: 提供查询当前邮件配置信息的资源，例如发送者地址和配置状态。
• 邮件模板资源: 提供HTML邮件模板示例，方便用户快速构建邮件内容。
• 功能格式资源: 提供关于邮件格式和内容类型的支持信息，例如允许的附件类型和大小限制。
• 工具示例资源: 提供每个邮件发送工具的使用示例和参数说明。

安装步骤

1. 环境准备: 确保已安装 Python 3.8 或更高版本。
2. 安装依赖: 在项目根目录下，运行以下命令安装项目依赖：

   pip install -r requirements.txt
   

3. 配置环境变量: 在项目根目录下创建 '.env' 文件，并配置 Azure Communication Services 的连接字符串和已验证的发送者邮箱地址：

   ACS_CONNECTION_STRING=your_azure_communication_services_connection_string
   ACS_SENDER_ADDRESS=your_verified_sender_address@your-domain.azurecomm.net
   

   请务必替换 'your_azure_communication_services_connection_string' 和 '[email protected]' 为您在 Azure 门户中获取的真实信息。

服务器配置

MCP客户端需要配置以下信息以连接到 'mcp-server-acsemail' 服务器：

{
  "serverName": "acs-email",
  "command": "python",
  "args": ["src/server.py"]
}

配置参数说明:

• 'serverName': 服务器名称，可以自定义，例如 "acs-email"。
• 'command': 启动服务器的命令，这里使用 'python' 解释器。
• 'args': 传递给 'python' 命令的参数，指定服务器脚本的路径 'src/server.py'。

基本使用方法

1. 启动服务器: 配置完成后，在项目根目录下运行以下命令启动 MCP 服务器：

   python src/server.py
   

   服务器成功启动后，将监听 MCP 客户端的请求。

2. MCP客户端调用: MCP 客户端可以使用配置信息连接到该服务器。连接成功后，客户端可以调用服务器提供的工具和资源，例如：

   • 调用 'send_email' 工具发送邮件。
   • 调用 'send_email_with_attachments' 工具发送带附件的邮件。
   • 调用 'send_bulk_email' 工具批量发送邮件。
   • 读取 'acs-email://config' 资源获取配置信息。
   • 读取 'acs-email://docs/html' 资源获取 HTML 邮件模板。
   • 读取 'acs-email://formats' 资源获取支持的邮件格式信息。
   • 读取 'acs-email://examples/{tool_name}' 资源获取工具使用示例 (将 '{tool_name}' 替换为具体的工具名称，例如 'send_email')。

   具体的工具和资源调用方法请参考 MCP 协议和客户端文档。