MCP Autojob Server

🚀 MCP サーバー構築ガイド

このプロジェクトは、オフィスの自動化を実現するためのMCPサーバーの構築方法を提供します。具体的には、日程管理、天気通知、メール確認、タスク管理などの機能を自動化することを目的としています。

🚀 クイックスタート

計画

オフィスの自動化を実現するために、以下の方法を採用します。

• 毎朝出勤後、自分の日程予定を確認します。
• 当日の天気を確認して通知します。
• メール内の返信待ちのメールリストを確認します。
• 協働ツール Jira で、まだ完了していない自分に割り当てられたタスクをリストアップします。

実施過程

環境構築

# uv のインストール
brew install uv

uv init [mcp-server-name] --python 3.12 # バージョン指定  
cd [mcp-server-name]
uv venv # .venv 仮想環境のインストール 
source .venv/bin/activate
uv add "mcp[cli]"

# toml ファイル（パッケージ）のインストール
cat pyproject.toml

# server.py ファイルの作成 
touch server.py

# cursor のインストール
brew install --cask cursor
cursor .

## cursor でコマンドを実行
cursor アプリを開く -> cmd + shift + p を押す -> Shell Command を実行：'cursor' コマンドをインストール

cursor の設定

# cursor ドキュメントの追加
Cursor 設定に入る -> 機能 -> ドキュメント >「+新しいドキュメントを追加」をクリック ->
- MCP 公式サイト (https://modelcontextprotocol.io/)
- MCP llm.txt (https://modelcontextprotocol.io/llms-full.txt)
- MCP Python SDK (https://github.com/modelcontextprotocol/python-sdk)

# cursor ルールの設定
https://cursor.directory/fastapi-python-microservices-serverless-cursor-rules を参考 -> npx コピーコマンドを実行：npx cursor-directory rules add fastapi-python-microservices-serverless-cursor-rules -> ターミナルで設定を実行

サーバーの実行

# 独自で実行
mcp dev server.py
mcp install server.py （実行後、agent cursor, claude を確認できます）

Docker（サーバーサブスクリプション時に使用）

# イメージをビルドしてコンテナを起動（バックグラウンドで実行）
$ docker compose up -d --build

# ログを表示（バックグラウンド実行時に適用）
$ docker compose logs -f

# サーバーを停止
$ docker compose down

# 同時に実行
$ docker compose down & docker compose up -d --build & docker compose logs -f

structlog のインストール

uv pip install structlog

単体テスト

uv pip install python-dotenv
uv pip install pytest requests

# テストを1つずつ実行
pytest test/test_github_tool.py
# すべてのテストを実行
pytest -v -s