SendGrid MCP サーバー

AIアシスタントがSendGridのWeb API v3を通じてメールの送信や連絡先の管理を行えるようにするPython製MCP（Model Context Protocol）サーバーです。

ツール

セットアップ

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

これにより、Claude DesktopのようなMCPクライアントがローカルサブプロセスに期待するstdioトランスポートでサーバーが実行されます。

動作確認

python smoke_test.py

登録済みツールの一覧を表示し、SendGridアカウントに対して1回のライブ呼び出しを実行します。対話形式でのスキーマ/ツール検査には：

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出力を確認してください。