Weekly Report Checker MCP Server

週報チェッカー MCP サーバー

Google スプレッドシートの週報提出状況を確認する MCP（Model Context Protocol）サーバーです。

機能

• 週報を未提出のメンバーを確認します
• 特定のメンバーの週報提出状況の詳細を取得します
• 提出状況の統計を確認します
• 週報の提出対象となるチームメンバー全員の一覧を取得します

前提条件

• Python 3.10 以降
• Google Sheets サービスアカウントの JSON ファイル（service_account.json）
• 「週報」Google スプレッドシートへのアクセス権

インストール

# Install the package
pip install -e .

# Install in Claude Desktop
./install_server.sh
# or
mcp install mcp_server.main --name "週報檢查器"

使い方

# Run in development mode
./run_server.sh
# or
mcp dev mcp_server.main

# Run directly
python -m mcp_server.main
# or
weekly-report-server

クライアントの例

サンプルクライアントを実行します：

python example_usage.py

API リファレンス

リソース

• weekly-report://status - 週報を未提出のメンバーを取得します
• weekly-report://stats - 提出状況の統計を取得します
• weekly-report://all-members - チームメンバー全員を取得します
• weekly-report://person/{name} - 特定のメンバーの提出状況を取得します

ツール

• check_missing_reports - 未提出の週報を確認します
• check_person_report - 特定のメンバーの週報を確認します
• get_submission_stats - 提出状況の統計を取得します