weekly-report-mcp

🚀 每周报告检查器 MCP 服务器

每周报告检查器 MCP 服务器是一个用于检查 Google 表格中每周报告提交情况的 MCP（模型上下文协议）服务器，能帮助团队高效掌握成员报告提交状态。

🚀 快速开始

在使用每周报告检查器 MCP 服务器前，请确保满足以下先决条件：

• Python 3.10 或更高版本
• Google Sheets 服务账户 JSON 文件 (service_account.json)
• 访问“週報”Google 表格的权限

✨ 主要特性

• 检查哪些人还未提交每周报告
• 获取特定人的报告状态详细信息
• 查看提交统计信息
• 列出所有应提交报告的团队成员

📦 安装指南

# 安装包
pip install -e .

# 在 Claude Desktop 上安装
./install_server.sh
# 或者
mcp install mcp_server.main --name "週報檢查器"

💻 使用示例

基础用法

# 以开发模式运行
./run_server.sh
# 或者
mcp dev mcp_server.main

# 直接运行
python -m mcp_server.main
# 或者
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 - 获取提交统计信息