f-work-mcp

# Work Daily Report MCP Server 一个基于 MCP (Model Context Protocol) 的工作日报生成服务器，能够自动跟踪代码变更并生成详细的工作日报。**特别增强了对Python文件的差异分析功能，为大语言模型提供详细的代码变更信息。** ## 功能特性 ### 🚀 核心功能 - **上班工具** (`work_start`): 记录工作开始时的代码状态 - **下班工具** (`work_end`): 记录工作结束状态并生成日报 - **状态查询** (`get_work_status`): 获取当前工作状态 - **日报查询** (`get_daily_report`): 获取指定日期的日报 - **文件差异分析** (`get_python_file_diff`): 获取指定Python文件的详细差异 ### 📊 跟踪内容 - Git 提交记录和状态 - 文件修改、新增、删除情况 - **Python文件内容差异分析** ⭐ - 工作时长统计 - 代码变更摘要 - 分支信息 ### 🔧 扩展功能 - 自动补全支持 - 自定义 HTTP 路由 - 资源访问接口 - 提示词生成 ### 🐍 Python文件差异功能 ⭐ - **完整内容跟踪**: 记录所有Python文件的完整内容 - **精确差异分析**: 使用difflib生成标准化的差异格式 - **行数统计**: 统计新增、删除、修改的代码行数 - **变更类型识别**: 区分新增、修改、删除的文件 - **LLM友好格式**: 提供结构化的差异数据，便于大语言模型分析 ## 安装和运行 ### 1. 安装依赖 ```bash uv sync ``` ### 2. 运行服务器 ```bash uv run mcp dev main.py ``` ### 3. 使用 MCP Inspector 服务器启动后，会打开浏览器访问 MCP Inspector 界面，你可以在那里测试所有功能。 ## 使用方法 ### 上班时 ```python # 记录工作开始状态（包含Python文件内容） work_start(working_directory=".") ``` ### 下班时 ```python # 记录工作结束状态并生成日报（包含代码差异） work_end(working_directory=".") ``` ### 查询状态 ```python # 获取当前工作状态 get_work_status(working_directory=".") # 获取指定日期的日报 get_daily_report(date="2024-01-15") # 获取指定Python文件的详细差异 get_python_file_diff(file_path="main.py") ``` ## 工具详解 ### 1. work_start **功能**: 记录工作开始状态（包含Python文件内容） **参数**: - `working_directory` (str): 工作目录路径，默认为当前目录 **返回**: ```json { "success": true, "message": "工作开始状态已记录", "timestamp": "2024-01-15T09:00:00", "working_directory": "/path/to/project", "branch_name": "main", "total_files": 150, "modified_files_count": 5, "git_commits_count": 25, "python_files_count": 12 } ``` ### 2. work_end **功能**: 记录工作结束状态并生成日报（包含代码差异） **参数**: - `working_directory` (str): 工作目录路径，默认为当前目录 **返回**: ```json { "success": true, "message": "工作结束状态已记录，日报已生成", "report": { "date": "2024-01-15", "work_start_time": "09:00", "work_end_time": "18:00", "working_hours": 9.0, "total_commits": 3, "modified_files_count": 5, "new_files_count": 2…