Mailjet Mcp Server

Mailjet MCP 服务

概述

本项目为 Mailjet API 提供 Model Context Protocol（MCP）服务，让兼容的 AI Agent（例如 Claude Desktop）能够通过标准化的工具接口与 Mailjet 的联系人、营销活动、细分、统计、工作流等 API 交互。

快速开始

通过 NPX 执行

本项目已发布到 NPM，可通过 NPX 执行。

要在本地启动服务，只需运行以下命令：

MAILJET_API_KEY="YOUR_api_key:YOUR_secret_key" npx mailjet-mcp-server

通常，你可以选择利用 AI 桌面应用，并将 Mailjet MCP 直接连接到该应用。在这种情况下，请添加以下 MCP 配置：

"mcpServers": {
   "mailjet": {
      "command": "npx",
      "args": [
        "-y",
        "@mailjet/mailjet-mcp-server"
      ],
      "env": {
        "MAILJET_API_KEY": "YOUR_api_key:YOUR_secret_key"
      }
   }
}

手动安装

1. 克隆仓库：

   git clone https://github.com/mailgun/mailjet-mcp-server.git
   cd mailjet-mcp-server
   

2. 安装依赖并构建：

   pnpm install
   

3. 配置 Claude Desktop：

   创建或修改配置文件：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json

然后启动 MCP 服务：

node src/mailjet-mcp.js

添加以下配置：

{
    "mcpServers": {
        "mailjet": {
            "command": "node",
            "args": ["CHANGE/THIS/PATH/TO/mailjet-mcp-server/src/mailjet-mcp.js"],
            "env": {
                "MAILJET_API_KEY": "YOUR_api_key:YOUR_secret_key"
            }
        }
    }
}

支持的环境变量

该服务目前支持以下环境变量：

MAILJET_API_KEY="your_api_key:your_secret_key" # REQUIRED, used for authenticating your account
MAILJET_API_REGION="eu" # OPTIONAL, used to change to the EU servers, if desired

测试

使用以下命令运行本地测试套件：

NODE_ENV=test pnpm test

Claude 示例提示词

查找联系人信息

Which of my contacts lists has the most subscribers?

获取并可视化发送统计数据

Would you be able to make a chart with email delivery statistics for the past week?

调试

MCP 服务通过 stdio 通信，请参阅 Model Context Protocol 的调试章节。

发布

此软件包发布在 Mailjet NPM 注册表中。Mailjet 团队负责发布软件包更新。 如果发现 Github 版本与 NPM 上提供的软件包存在任何差异，欢迎创建 issue。

许可证

本项目采用 Apache License 2.0 许可。详情请参阅 LICENSE。

贡献

欢迎贡献！请随时提交 Pull Request。