Daily Work MCP Server

# Daily Work MCP Server 一个用于记录、查询和总结每日工作内容的本地 MCP Server，基于 FastAPI + FastMCP + SQLite 实现。 ## 运行前准备 1. 安装依赖： ```bash conda create -n daily-work-mcp python=3.11 -y conda activate daily-work-mcp pip install -r requirements.txt ``` 2. 初始化数据库（首次运行必须执行）： ```bash python scripts/init_db.py ``` ## 启动方式 ### 启动 HTTP API（可选） ```bash uvicorn app.main:app --reload ``` 默认监听 `http://127.0.0.1:8000`，包含以下 REST 接口： - `POST /entries`：新增工作内容 - `GET /entries`：按 `daily`/`weekly` 查询 - `GET /entries/search`：全文搜索 - `GET /entries/export`：导出 JSON 或 CSV - `GET /entries/summary`：最近 N 天标签聚合 - `GET /entries/reminder`：检查今日是否已有记录 - `GET /tags` / `POST /tags`：标签管理 ### 启动 MCP Server ```bash python scripts/run_mcp_server.py ``` 默认以 STDIO transport 运行；如果需要通过 HTTP/Streamable HTTP 暴露端口，可改用： ```bash python scripts/run_mcp_server.py --transport streamable-http --host 127.0.0.1 --port 8888 ``` 脚本在 HTTP/Streamable 模式下会自动启用 **stateless HTTP**，即 `/mcp` 端点无需任何 Session/Cookie 即可访问，方便 IDE 直接连到 `http://127.0.0.1:8888/mcp`。 手工调试时记得同时声明 `Accept: application/json, text/event-stream`，例如： ```bash curl -N \ -H "Accept: application/json, text/event-stream" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":"1","method":"ping","params":{}}' \ http://127.0.0.1:8888/mcp ``` 该脚本会调用 `app/mcp/server.py` 中的 `mcp.run()` 并注册全部工具： - `record_work_entry`：新增条目 - `list_work_entries`：按日/周查询 - `search_work_entries`：关键字检索 - `summarize_recent_work`：标签汇总 - `check_today_recorded`：今日提醒状态 - `list_tags` / `create_tag`：标签列表与新增 MCP 客户端连接该进程后即可直接调用上述工具。 ## 使用示例 - **新增条目**（REST）： ```bash curl -X POST http://127.0.0.1:8000/entries \ -H "Content-Type: application/json" \ -d '{"description":"排查登录问题","tags":["infra/login"]}' ``` - **查询本周条目**（REST）： ```bash curl "http://127.0.0.1:8000/entries?range=weekly" ``` - **MCP 调用**：在支持 MCP 的客户端中，将 `scripts/run_mcp_server.py` 作为 Server 入口，即可在会话中调用 `record_work_entry`、`list_work_entries` 等工具。 更多需求说明见 `requirements.md`。