每周报告系统

每周报告系统旨在方便创建和管理每周报告，这些报告存储在 reports 目录中，并带有时间戳，以便于跟踪。

设置

要开始使用每周报告系统，请按照以下步骤操作：

1. 安装依赖项： 确保您已安装所有必需的 Python 包，方法是运行：

   pip install -r requirements.txt
   

2. 运行 MCP 服务器： 启动 MCP 服务器以启用报告创建：

   python weekly_report_server.py
   

用法

该系统提供两种创建每周报告的方法：

方法 1：直接 Python 脚本

通过执行 create_weekly_report.py 脚本来创建每周报告：

python create_weekly_report.py

此脚本利用 weekly_report_server.py 中的 write_weekly_report 函数来生成报告内容。

方法 2：MCP 工具（需要带有 Claude 扩展的 VSCode）

利用带有 VSCode 中 Claude 扩展的 MCP 服务器功能：

1. MCP 配置： 确保 MCP 设置在 .fastmcp.toml 和 mcp.json 中正确配置。

2. VSCode 扩展配置： 验证以下位置的扩展设置：

   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

配置完成后，使用 MCP 服务器中的 write_weekly_report 工具直接在 VSCode 中创建报告。

报告格式

报告存储在 reports 目录中，文件名格式为 weekly_report_YYYYMMDD_HHMMSS.txt。

建议的报告结构如下：

每周报告 - [日期]

已完成事项：
1. [已完成事项 1]
2. [已完成事项 2]
3. [已完成事项 3]
4. [已完成事项 4]

下一步计划：
1. [下一步计划 1]
2. [下一步计划 2]
3. [下一步计划 3]
4. [下一步计划 4]

项目文件

• weekly_report_server.py： 核心服务器文件，定义了 write_weekly_report 函数并设置了 MCP 服务器。
• create_weekly_report.py： 调用 write_weekly_report 函数以生成报告的脚本。
• test_weekly_report.py： 用于验证 write_weekly_report 函数的测试脚本。
• reports/： 保存所有生成的报告的目录。

附加信息

如需更多帮助或咨询，请参阅项目文档或联系开发团队。