关键词

邮件发送Postmark集成模板管理邮件统计API调用

项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器，专门用于与 Postmark 邮件服务 API 集成。它允许兼容 MCP 协议的大语言模型（LLM）客户端通过标准化的方式调用 Postmark 的各项功能，如发送事务性邮件、管理邮件模板、获取发送统计数据等。

主要功能点

  • 邮件发送: 支持发送单封纯文本邮件、批量发送邮件，以及使用预设模板发送邮件。
  • 模板管理: 能够创建、更新、列出和获取 Postmark 账户中的邮件模板详情。
  • 统计查询: 提供获取邮件投递统计信息（如发送量、打开率、点击率）和查询近期发送邮件记录的能力。
  • 域名管理: 支持添加新的发信域名并验证其 DKIM 和 Return-Path 配置。

安装步骤

要运行此 MCP 服务器，您需要 Node.js 环境和一个 Postmark 账户及有效的服务器 API Token。

  1. 克隆仓库: 
    git clone https://github.com/jaballer/postmark-mcp-server.git
cd postmark-mcp-server
  2. 安装依赖: 
    npm install
  3. 配置环境变量:
    • 复制示例环境文件：'cp .env.example .env'
    • 编辑 '.env' 文件，填入您的 Postmark 服务器 Token 和默认设置： 
      POSTMARK_SERVER_TOKEN=您的Postmark服务器API Token
DEFAULT_SENDER_EMAIL=默认发件人邮箱地址
DEFAULT_MESSAGE_STREAM=默认邮件流（通常是 outbound）
  4. 运行服务器: 
    node postmark-mcp-server.js
    服务器启动后，会监听标准输入输出（Stdio）端口，等待 MCP 客户端连接。

服务器配置（供MCP客户端使用）

MCP 客户端连接此服务器时，通常需要在其配置中指定服务器的启动方式。对于此 Postmark MCP 服务器，使用 Stdio 传输协议，其配置信息如下：

  • 服务器名称 (name): 'postmark-mcp'
  • 启动命令 (command): 'node'
  • 命令参数 (args): '["postmark-mcp-server.js"]'
  • 传输协议 (transport): 'stdio'

MCP 客户端会根据以上信息启动此 Node.js 脚本，并通过标准输入输出来与服务器进行基于 JSON-RPC 的 MCP 协议通信。

基本使用方法

一旦 MCP 客户端连接到此 Postmark MCP 服务器，LLM 就可以通过自然语言描述所需操作（例如：“使用 Postmark 发送一封邮件给 [email protected]，主题是'测试邮件'，内容是'这是一封测试邮件'”）。MCP 客户端会解析LLM的意图，识别出对应的工具（如 'sendEmail'），并根据LLM提供的细节构建工具调用的 JSON Payload。客户端将 Payload 发送给此 Postmark MCP 服务器，服务器执行相应的 Postmark API 调用，并将结果返回给客户端，最终呈现给LLM。

您可以参考仓库 README 中的“Tool Reference”部分，查看每个工具支持的参数和示例。

信息

分类

开发者工具

访问项目