job-mcp

FastMCP サーババー（stdio トランスポート）の機能：

• リソース cv://profile — LLMクライアントが読み取るためのあななたのCV/履歴書をJSONで提供します。

• ツール send_email — Red Mail を使用して SMTP でメールを送信します。

ワークフロー: チャットでMCPクライアントに求人情報と採用担当者のメールを渡す → クライアントが cv://profile を読み取る → それに合わせた応募メールを作成する → send_email を呼び出して送信する。

1. インストール

cd job-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Related MCP server: MCP Server

2. SMTP認証情報の設定

cp .env.example .env

.env を SMTP ホスト/認証情報で編集します。Gmail の場合は、通常のログインパスワードではなく アプリ パスワード を使用し、 先に 2 段階認証を有効にしてください。

3. CVを記入する

src/job_mcp/data/cv.json を実際の情報（連絡先、スキル、職歴、 学歴、プロジェクト、資格）で編集します。このリソースはこのファイルをそのまま読み取るだけです。

4. サーバーを単体で実行する（動作確認）

python -m job_mcp.server

このサーバーは stdin/stdout 上で MCP JSON-RPC メッセージを待機したままになります（これは正常です。MCPクライアントから 起動されることを想定しており、対話的に使うものではありません）。

MCP dev inspector で確認することもできます：

mcp dev src/job_mcp/server.py

5. MCPクライアントに接続する

stdio でサーバーを起動するクライアントの設定例（例: Claude Desktop の claude_desktop_config.json）：

{
  "mcpServers": {
    "job-mcp": {
      "command": "/absolute/path/to/job-mcp/.venv/bin/python",
      "args": ["-m", "job_mcp.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_SENDER_EMAIL": "you@gmail.com",
        "SMTP_SENDER_NAME": "Your Name"
      }
    }
  }
}

（ここでは認証情報を .env の代わりに env に入れることもできます。どちらでも動作します。 config.py はどちらにせよ os.environ から読み取るためです。）

6. 使い方

クライアントに次のようなものを貼り付けます：

求人情報と採用担当者のメールをここに貼り付けます。私のCVリソースを読み、それに合わせた 応募メールを作成して送信してください。

求人情報: 採用担当者メール: hr@company.com

クライアントは cv://profile を呼び出し、その両方のコンテキストを使用してメールを作成し、 send_email(to=..., subject=..., body_html=..., body_text=...) を呼び出します。

メモ / 後で堅牢化すべき点

• send_email には現在、サーバー自体に確認ステップが組み込まれていません。「送信前に確認する」というガードレールをサーバー側（クライアント側だけでなく）で強制したい場合は、 2段階のフロー（プレビューとIDを返す draft_email ツールと、実際に送信する confirm_send ツール）を追加してください。

• 誤って重複送信してしまわないように、レート制限や送信済みメールのログ記録を検討してください。

• cv.json はリソースが呼び出されるたびに新しく読み込まれるため、サーバーを再起動せずに編集できます。