e-worker-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@e-worker-mcp 把这段会议纪要转成待办并记录工时"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
e-worker-mcp
一个本地优先的 MCP 服务器,替你处理日常工作中的琐事。
把会议纪要变成待办、记录工时、生成日报、整理文件、诊断开发环境——全部通过你的 AI 助手完成,每一次写操作都由人工维护的安全策略把关。
English · 功能特性 · 快速开始 · 工具清单 · 安全模型 · 架构
这是什么?
e-worker-mcp 是一个 Model Context Protocol (MCP) 服务器,为 AI 助手提供一套安全、本地的日常工作工具箱:
会议纪要 → 待办:从会议记录中提取行动项
待办管理:五态状态机覆盖全生命周期
工时记录:按待办记录时长,聚合进报表
日报 / 周报:按类别(工作 / 学习)自动汇总
文件整理:基于规则的整理——只移动文件,绝不删除
环境诊断:只读检查并给出可执行的建议
它运行在纯 stdio 进程中——没有 HTTP daemon、不开放端口,数据保存在本机本地 SQLite 数据库中。
Related MCP server: uacos
功能特性
领域 | 能力 |
📋 待办 | 创建 / 更新 / 状态流转 / 组合过滤查询(状态、分类、关键词、标签) |
🗂 分类 | 每个事项标记为 |
🕐 工时 | 按待办记录工时,支持日期范围查询与总量统计 |
📊 报表 | 完成事项 + 工时的日报 / 周报聚合 |
📝 会议纪要 | 动作词检测 → 待办草案(日期短语自动转为截止时间) |
🗃 文件 | 扫描、规则化整理(仅移动)、清理进 |
🔍 诊断 | 只读环境采集(工具链版本、PATH、监听端口、磁盘)+ 带建议的问题报告 |
🔐 安全 | 白名单 / 黑名单双模式裁决;敏感域( |
💾 可迁移 | schema 版本化 + 迁移、JSON/CSV 导入导出、存储抽象层 |
快速开始
环境要求
Python ≥ 3.11
uv(推荐)或 pip
安装
cd e-worker-mcp
uv venv --python 3.12
uv pip install -e ".[dev]"Windows:
uv pip install --python .venv\Scripts\python.exe -e ".[dev]"
接入 MCP 客户端
在 MCP 客户端配置(Claude Desktop、Kilo、Qoder 等)中添加 stdio server:
{
"mcpServers": {
"e-worker-mcp": {
"command": "/绝对/路径/e-worker-mcp/.venv/bin/python",
"args": ["-m", "e_worker.server"],
"cwd": "/绝对/路径/e-worker-mcp"
}
}
}Windows 示例:
command: "D:\\路径\\e-worker-mcp\\.venv\\Scripts\\python.exe"
试试看
接入后直接用自然语言吩咐 AI:
「记录一个待办:明天提交报销单(工作)」
「列出我当前所有的待办」
「整理这段会议纪要:……」
「今天给 XX 事项记 2 小时编码工时」
「生成今天的日报」
「扫描一下我的下载目录」
「检查一下开发环境」
工具清单
共 24 个工具。每个写工具都成对提供 preview / apply——preview 展示影响(dry-run,无副作用),apply 在裁决通过后执行。
待办与报表
工具 | 说明 |
| 创建事项( |
| 更新事项 |
| 状态流转: |
| 组合过滤查询( |
| 会议纪要 → 待办草案(绝不写库) |
| 工时记录与查询 |
| 日报 / 周报聚合(work / study 分列) |
数据迁移
工具 | 说明 |
| 导出 JSON / CSV(只读;拒绝覆盖已存在文件) |
| 导入(冲突检测 + merge 语义) |
文件与环境
工具 | 说明 |
| 只读扫描:名称 / 大小 / mtime / 扩展名 |
| 规则化整理(仅移动;目标冲突跳过) |
| 匹配文件移入 |
| 只读环境采集(版本 / PATH / 端口 / 磁盘) |
| 问题报告 + 建议动作(绝不自动执行) |
| 只读:当前 mode / allow_rules / auto_approve——会话开始时先调用 |
安全模型
所有写操作都经过两阶段流程:
preview(dry-run 影响清单)
→ 安全裁决
→ apply(执行)裁决由 config.json 驱动——人工维护,AI 只读:
{
"safety": {
"mode": "whitelist",
"auto_approve": ["todo.*", "time.*", "report.*", "meeting.*"],
"allow_rules": ["todo.*", "meeting.*", "time.*", "report.*"],
"deny_rules": ["file.delete", "env.modify"]
},
"file": {
"trash_dir": ".trash"
}
}模式 | 策略 |
| 默认拒绝:操作必须命中 |
| 默认放行:命中 |
附加保证:
auto_approve信任域:命中auto_approve的操作(低风险:待办/工时/日报/纪要)一步直达,无需逐次确认弹窗;其余操作(如file.*、env.*、db.import)仍必须先 preview 展示影响并征求用户确认后再 apply敏感域(
file.*、env.*)在任一模式下,只要规则未明确覆盖,一律升级为人工批准会话开始时调用只读工具
safety_policy可查看当前 mode / allow_rules / auto_approve每次裁决都记录到
logs/e-worker/security.log(操作、模式、命中规则、决策)规则粒度 = 操作类 × 路径 glob,如
todo.*、file.move|~/notes/**文件操作仅移动;清理进入
.trash/回收区,同名冲突自动加时间戳后缀——代码库中不存在物理删除路径
数据存储与迁移
本地 SQLite(WAL 模式):
db/e-worker.db——无外部服务依赖Schema 演进:
src/e_worker/migrations/NNN_*.sql顺序迁移脚本,启动时在事务内自动应用未执行版本,schema_version表记录,失败即回滚导出 / 导入:
db_export→db_import支持跨机迁移与备份(JSON / CSV,含 tags 与 metadata)存储抽象:所有 SQL 集中在
storage/repository.py,业务层不直接写 SQL——未来切换 PostgreSQL 只需替换存储层向前兼容:
items.metadataJSON 字段为未来能力预留;新特性通过新增迁移脚本扩展,不动已有表
架构
AI 助手(stdio MCP 客户端)
│ 工具调用
▼
server.py ── 工具注册 + preview/apply 分发
│
├─ 只读工具 → services/* 直接执行
│
└─ 写工具(两阶段)
preview: 安全裁决 → dry-run 影响清单
apply: 安全复检 → services → storage
│
▼
storage/repository.py ←── 唯一 SQL 访问层
│
▼
db/e-worker.db(SQLite WAL,schema_version 表)
▲
│ 启动时:migrations/NNN_*.sql 事务内应用
▼
config.py ←── config.json(人工维护的安全规则)src/e_worker/
├── server.py # MCP 入口,工具注册
├── config.py # 安全配置加载
├── security.py # 白名单/黑名单裁决
├── models.py # Item / TimeEntry 模型,状态机
├── storage/
│ ├── db.py # 连接、WAL、迁移
│ ├── repository.py # SQL 层(items, time_entries)
│ └── migrations/ # 001_init.sql, 002_time_entries.sql, ...
├── services/
│ ├── todo_service.py # 事项 CRUD + 状态机
│ ├── time_service.py # 工时记录
│ ├── meeting_service.py # 纪要 → 待办草案
│ ├── report_service.py # 日报/周报聚合
│ ├── file_service.py # 扫描 / 整理 / 清理(回收区)
│ └── diagnose_service.py# 环境采集与问题报告
└── tools/ # MCP 工具定义(preview/apply 成对)测试
uv run pytest tests/ -vWindows:
.venv\Scripts\python.exe -m pytest tests/ -v
覆盖范围:迁移(幂等 / 回滚 / 约束)、双模式裁决、待办状态机、preview/apply 裁决链、纪要提取、工时记录、日报/周报、导出/导入往返、文件整理/清理、环境诊断。
路线图
MVP:待办、工时、日报、纪要提取、双模式安全、迁移与导出/导入
C 组:文件整理(仅移动 + 回收区)与环境诊断(只读)
环境修复自动执行(显式人工批准后;建议动作已就绪)
跨平台诊断(Linux
ss/ps对齐现有 Windowsnetstat/tasklist实现)
许可证
本项目尚未指定许可证。使用或分发前请联系维护者。
Python · MCP SDK · SQLite 构建
Available Tools
25 toolsdb_exportA
导出数据库为 JSON/CSV(只读操作),拒绝覆盖已存在路径。
Inputs: path, format. Returns: result
db_import_applyA
实际导入数据(需先 preview 且通过裁决);merge=false 且库非空会被拒绝。
Inputs: path (required), merge, format. Returns: result
db_import_previewA
预览导入影响:来源文件、将导入条数、id 冲突检测、是否需清库(dry-run)。
Inputs: path (required), merge, format. Returns: result
diagnose_collectA
只读采集本机环境信息:Python/Node/Go 版本、PATH、端口监听列表、磁盘余量。不监听不绑定端口。
Inputs: no named parameters. Returns: result
diagnose_reportA
生成环境诊断报告:问题清单(磁盘不足/工具缺失/契约端口异常占用)+ 建议动作(不自动执行,需人工确认)。
Inputs: no named parameters. Returns: result
file_clean_applyA
实际清理(需先 preview 且通过裁决):移入 .trash/ 回收区,绝不物理删除。
Inputs: path (required), pattern (required). Returns: result
file_clean_previewA
预览清理匹配文件的影响(dry-run):文件将移入 .trash/ 而非删除。
Inputs: path (required), pattern (required). Returns: result
file_organize_applyA
实际执行归档移动(需先 preview 且通过裁决);目标冲突跳过,不物理删除。
Inputs: path (required), rules (required). Returns: result
file_organize_previewA
预览按规则归档的影响清单(dry-run,不移动文件)。rules 每项含 pattern(glob) 与 target(目标子目录)。
Inputs: path (required), rules (required). Returns: result
file_scanA
只读扫描目录,返回文件元数据(名称/路径/大小/mtime/扩展名)与子目录列表。
Inputs: path (required), pattern. Returns: result
meeting_extractA
从会议纪要文本提取待办草案(动作词扫描+日期转截止时间),仅返回草案不写库;确认后调用 todo_create_apply 落库。
Inputs: text (required), category. Returns: result
report_dailyB
生成日报:当日完成事项(work/study 分列)+ 当日工时总分钟。
Inputs: day. Returns: result
report_weeklyB
生成周报:按日分组完成数 + 分类汇总 + 工时总分钟。
Inputs: start_day. Returns: result
safety_policyA
只读返回当前安全策略(mode/allow_rules/deny_rules/auto_approve)。会话开始时先调用本工具,auto_approve 命中域可直接执行,未命中域必须先 preview 征求用户确认。
Inputs: no named parameters. Returns: result
time_listA
查询工时记录,支持按 item_id/日期范围过滤,返回总分钟数。
Inputs: date_to, item_id, date_from. Returns: result
time_log_applyA
实际记录工时(需先 preview 且通过裁决)。duration_minutes 为正整数。
Inputs: date (required), item_id (required), duration_minutes (required), note. Returns: result
time_log_previewA
预览记录工时的影响(dry-run,不写库)。
Inputs: date (required), item_id (required), duration_minutes (required), note. Returns: result
todo_create_applyA
实际创建事项(需先 preview 且通过白/黑名单裁决)。category 必填:work/study。
Inputs: title (required), category (required), due, tags, +3 more. Returns: result
todo_create_previewA
预览创建事项的影响(dry-run,不写库)。先调用本工具展示影响清单,再调用 todo_create_apply 执行。
Inputs: title (required), category (required), due, tags, +3 more. Returns: result
todo_getA
按 id 查询单个事项详情。
Inputs: item_id (required). Returns: result
todo_listA
查询事项列表,支持 status/category/keyword/tag 组合过滤,按创建时间倒序。
Inputs: tag, limit, offset, status, +2 more. Returns: result
todo_transition_applyA
实际流转事项状态(需先 preview 且通过裁决)。流转到 done 自动写 completed_at。
Inputs: item_id (required), new_status (required). Returns: result
todo_transition_previewA
预览事项状态流转的影响(dry-run)。状态机:inbox→todo→doing→done→archived。
Inputs: item_id (required), new_status (required). Returns: result
todo_update_applyA
实际更新事项(需先 preview 且通过裁决)。
Inputs: item_id (required), due, tags, notes, +3 more. Returns: result
todo_update_previewA
预览更新事项的影响(dry-run,不写库)。
Inputs: item_id (required), due, tags, notes, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool has a clearly distinct purpose: read-only queries, preview dry-runs, and apply mutations are separated with explicit _preview and _apply suffixes. Resource-specific operations (todo, time, file, db, diagnose) are well compartmentalized, leaving no ambiguity between tools.
Most tools follow a resource_action or resource_action_preview/apply pattern in snake_case (e.g., todo_list, todo_create_apply, db_export). However, a few outliers like safety_policy, report_daily, report_weekly, diagnose_report, and diagnose_collect deviate from the verb_noun convention, making the set slightly inconsistent.
At 25 tools, the server covers multiple domains (todos, time logging, reports, diagnostics, file management, DB import/export), which explains the large count. While each tool serves a purpose, the set feels heavy and may overwhelm agents; it sits at the top of the 'borderline' range for tool count.
The tool surface covers core workflows: todo lifecycle (create, update, transition, list, get), time logging, daily/weekly reports, file operations, diagnostics, and DB import/export. Minor gaps exist, such as no update/delete for time logs, no explicit todo delete (though archived status may suffice), and diagnostic suggestions are not executable within the server.
Maintenance
Related MCP Connectors
Work management where AI agents are first-class members: tasks, projects, memory over hosted MCP
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceA local MCP server that records completed tasks to daily JSONL files and promotes substantial work to a cumulative weekly Markdown worklog, providing persistent, searchable logs of AI-assisted productivity.MIT
- AlicenseNot gradedqualityBmaintenanceLocal-first code intelligence and safety layer for AI coding agents. MCP server exposes dependency graph, impact analysis, and AST-compressed repo context, backed by typed local memory, patch-scope safety gates, and git-independent transaction rollback.1MIT
- AlicenseBqualityCmaintenanceA local-first open-source MCP server that acts as a personal secretary, memory manager, and automation hub—it syncs Calendar, Gmail, Canvas, GitHub, and Health into a typed temporal memory graph, and enables approval-gated write actions like creating events, drafting/sending mail, and filing issues, all with telegram/slack/CLI interfaces and a SQLite-backed audit trail.33Apache 2.0
- AlicenseNot gradedqualityBmaintenanceA local-first MCP server that enables AI-assisted coding through workspace-scoped tools for file reading/editing, command execution, jobs, Git, LSP, media, browser, and desktop workflows. It enforces OAuth, workspace ACL, trust policies, and file/secret guards so owners can safely grant inspect, edit, or trusted capabilities.346 npmMIT