SendGrid MCP Server

一个 Python MCP（Model Context Protocol）服务器，让 AI 助手能够发送 电子邮件并通过 SendGrid 的 Web API v3 管理联系人。

工具

设置

1. 创建虚拟环境并安装依赖项：

   python -m venv venv
   source venv/bin/activate   # Windows: venv\Scripts\activate
   pip install -r requirements.txt

2. 将 .env.example 复制为 .env，并填写你的 SendGrid API 密钥 （SendGrid 控制台中的 Settings > API Keys）和默认发件人：

   cp .env.example .env

3. 发送前，请在 SendGrid 的 Settings > Sender Authentication 下验证你的发件人邮箱， 未验证的发件人将被拒绝。

4. （可选）在 Email API > Dynamic Templates 下创建动态模板， 并在 .env 中设置 DEFAULT_TEMPLATE_ID。

运行

python main.py

这会通过 stdio 运行服务器，这是 Claude Desktop 等 MCP 客户端 对本地子进程所期望的传输方式。

验证是否正常工作

python smoke_test.py

列出已注册的工具，并对你的 SendGrid 账户发起一次实时调用。如需进行交互式 schema/工具检查：

npx @modelcontextprotocol/inspector python main.py

连接到 Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "sendgrid-mcp": {
      "command": "python",
      "args": ["/path/to/twilio-sendgrid-mcp/main.py"],
      "cwd": "/path/to/twilio-sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your-actual-api-key-here"
      }
    }
  }
}

之后重启 Claude Desktop。如果某个工具调用失败，请检查 ~/Library/Logs/Claude/mcp*.log（macOS）以查看服务器的 stderr 输出。