{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jh5fs99zjvvx","handle":"f-work-mcp","url":"https://wellknown.network/agents/f-work-mcp","links":{"self":"https://wellknown.network/agents/f-work-mcp/record.json","html":"https://wellknown.network/agents/f-work-mcp","markdown":"https://wellknown.network/agents/f-work-mcp/record.md","api":"https://wellknown.network/api/v1/agents/f-work-mcp","status":"https://wellknown.network/api/v1/agents/f-work-mcp/status","claim":"https://wellknown.network/agents/f-work-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/f-work-mcp/claim.json","badge":"https://wellknown.network/agents/f-work-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/f-work-mcp/history","tools":"https://wellknown.network/api/v1/agents/f-work-mcp/tools"},"ard":{"identifier":"urn:air::server:f-work-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"f-work-mcp","summary":"A MCP server for tracking work progress and generating daily reports with Python file diff analysis","description":"# Work Daily Report MCP Server\n\n一个基于 MCP (Model Context Protocol) 的工作日报生成服务器，能够自动跟踪代码变更并生成详细的工作日报。**特别增强了对Python文件的差异分析功能，为大语言模型提供详细的代码变更信息。**\n\n## 功能特性\n\n### 🚀 核心功能\n- **上班工具** (`work_start`): 记录工作开始时的代码状态\n- **下班工具** (`work_end`): 记录工作结束状态并生成日报\n- **状态查询** (`get_work_status`): 获取当前工作状态\n- **日报查询** (`get_daily_report`): 获取指定日期的日报\n- **文件差异分析** (`get_python_file_diff`): 获取指定Python文件的详细差异\n\n### 📊 跟踪内容\n- Git 提交记录和状态\n- 文件修改、新增、删除情况\n- **Python文件内容差异分析** ⭐\n- 工作时长统计\n- 代码变更摘要\n- 分支信息\n\n### 🔧 扩展功能\n- 自动补全支持\n- 自定义 HTTP 路由\n- 资源访问接口\n- 提示词生成\n\n### 🐍 Python文件差异功能 ⭐\n- **完整内容跟踪**: 记录所有Python文件的完整内容\n- **精确差异分析**: 使用difflib生成标准化的差异格式\n- **行数统计**: 统计新增、删除、修改的代码行数\n- **变更类型识别**: 区分新增、修改、删除的文件\n- **LLM友好格式**: 提供结构化的差异数据，便于大语言模型分析\n\n## 安装和运行\n\n### 1. 安装依赖\n```bash\nuv sync\n```\n\n### 2. 运行服务器\n```bash\nuv run mcp dev main.py\n```\n\n### 3. 使用 MCP Inspector\n服务器启动后，会打开浏览器访问 MCP Inspector 界面，你可以在那里测试所有功能。\n\n## 使用方法\n\n### 上班时\n```python\n# 记录工作开始状态（包含Python文件内容）\nwork_start(working_directory=\".\")\n```\n\n### 下班时\n```python\n# 记录工作结束状态并生成日报（包含代码差异）\nwork_end(working_directory=\".\")\n```\n\n### 查询状态\n```python\n# 获取当前工作状态\nget_work_status(working_directory=\".\")\n\n# 获取指定日期的日报\nget_daily_report(date=\"2024-01-15\")\n\n# 获取指定Python文件的详细差异\nget_python_file_diff(file_path=\"main.py\")\n```\n\n## 工具详解\n\n### 1. work_start\n**功能**: 记录工作开始状态（包含Python文件内容）\n\n**参数**:\n- `working_directory` (str): 工作目录路径，默认为当前目录\n\n**返回**:\n```json\n{\n  \"success\": true,\n  \"message\": \"工作开始状态已记录\",\n  \"timestamp\": \"2024-01-15T09:00:00\",\n  \"working_directory\": \"/path/to/project\",\n  \"branch_name\": \"main\",\n  \"total_files\": 150,\n  \"modified_files_count\": 5,\n  \"git_commits_count\": 25,\n  \"python_files_count\": 12\n}\n```\n\n### 2. work_end\n**功能**: 记录工作结束状态并生成日报（包含代码差异）\n\n**参数**:\n- `working_directory` (str): 工作目录路径，默认为当前目录\n\n**返回**:\n```json\n{\n  \"success\": true,\n  \"message\": \"工作结束状态已记录，日报已生成\",\n  \"report\": {\n    \"date\": \"2024-01-15\",\n    \"work_start_time\": \"09:00\",\n    \"work_end_time\": \"18:00\",\n    \"working_hours\": 9.0,\n    \"total_commits\": 3,\n    \"modified_files_count\": 5,\n    \"new_files_count\": 2…","publisher":null,"homepage":"https://github.com/your-username/f-work-mcp#readme","repository":"https://github.com/your-username/f-work-mcp/blob/main/CHANGELOG.md","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["daily-report","git","mcp","productivity","python","work-tracking"],"pricing":null,"endpoints":[{"url":"pypi:f-work-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["analytics","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"f-work-mcp","registry":"pypi","observedAt":"2026-09-15T15:24:31.470Z","publishedAt":"2025-07-30T01:45:41.628852Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"f-work-mcp","url":"https://pypi.org/project/f-work-mcp/","firstSeenAt":"2026-09-09T16:23:10.374Z","fetchedAt":"2026-09-15T15:22:30.419Z","normalizedAt":"2026-09-15T15:22:30.419Z"}]},"firstSeenAt":"2026-09-09T16:23:10.374Z","updatedAt":"2026-09-15T15:24:31.470Z"}