mcpField
M
mailport

mailport

ローカル
github.com/CloudCorpRecordsコミュニケーション02 週間前に更新
リポジトリ

mailport について

mailportは、Gmail APIを介してメール、スレッド、ラベル、下書きの操作や送信を行うMCPサーバーです。中核となる10種類のツールを提供します。

主な機能

  1. 01メールの一覧表示と取得
  2. 02スレッドの一覧表示と取得
  3. 03ラベルの一覧表示
  4. 04メールの送信
  5. 05下書きの作成
  6. 06メールの変更・ゴミ箱移動、ラベル作成

活用シーン

  1. 01受信トレイのメールやスレッドの確認
  2. 02Gmailメールの送信
  3. 03メールの下書き作成
  4. 04ラベルを使ったメール整理

MCP 対応

メールやスレッドの取得、ラベルの一覧表示と作成、送信、下書き作成、メールの変更とゴミ箱移動など、Gmail APIの10操作をMCPツールとして公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "cloudcorprecords-mailport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/mailport"
      ]
    }
  }
}
起動コマンドnpx -y @reneturcios/mailport

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@reneturcios/mailport0.1.0
ocighcr.io/cloudcorprecords/mailport:0.1.0

ツール

10

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
querystringいいえメールの絞り込みに使用する任意の Gmail 検索クエリ。
label_idsarrayいいえ任意のラベル ID リスト。指定したすべてのラベルが付いたメールのみを返します。
max_resultsnumberいいえ返すメールの最大件数（任意）。

詳細

mailport

Gmail API と通信し、Gmail のメッセージ、スレッド、ラベルを MCP ツールとして提供します。mailport は、Gmail のリファレンス MCP サーバーの主要な機能を、新しい名前でクリーンルーム方式で再構築したものです。公開されている Gmail API ドキュメントを基に新たにコードを記述しており、ブランド表現をコピーしていません。

ツール（主要な 10 種類）

list_messages、get_message、list_threads、get_thread、 list_labels、send_message、create_draft、modify_message、 trash_message、create_label。

Gmail の幅広い機能に含まれるラベルの更新／削除、下書きの取得／更新／削除／送信、メッセージの削除と batchModify、履歴、プロフィール／設定／watch、添付ファイルのダウンロードは、このサブセットには含まれていません。

セットアップ

Google OAuth アクセストークンを設定します。

export GOOGLE_ACCESS_TOKEN=ya29....

必要に応じて、GMAIL_API_URL で API ベース URL を上書きできます（デフォルトは https://gmail.googleapis.com/gmail/v1）。トークンが設定されていない場合、すべてのツール呼び出しは、不足している変数の名前を示すエラーで失敗します。

CLI

npx @reneturcios/mailport list_messages '{"query":"in:inbox","max_results":5}'
npx @reneturcios/mailport mcp        # stdio MCP server

各ツール名はサブコマンドであり、引数として 1 つの JSON オブジェクトを受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "mailport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/mailport", "mcp"],
      "env": { "GOOGLE_ACCESS_TOKEN": "ya29...." }
    }
  }
}

Docker

docker run -i -e GOOGLE_ACCESS_TOKEN ghcr.io/cloudcorprecords/mailport

開発

npm install
npm run build
npm test

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。