AI导哈

工作记录服务

一个用于记录、查询和总结每日工作内容的本地MCP服务器，基于FastAPI和SQLite实现。

  • by hsgui
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hsgui/daily-work-mcp

使用说明

Daily Work MCP Server

一个用于记录、查询和总结每日工作内容的本地 MCP Server，基于 FastAPI + FastMCP + SQLite 实现。

运行前准备

  1. 安装依赖：
    conda create -n daily-work-mcp python=3.11 -y
conda activate daily-work-mcp
pip install -r requirements.txt
  2. 初始化数据库（首次运行必须执行）：
    python scripts/init_db.py

启动方式

启动 HTTP API（可选）

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

python scripts/run_mcp_server.py

默认以 STDIO transport 运行；如果需要通过 HTTP/Streamable HTTP 暴露端口，可改用：

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，例如：

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）：
    curl -X POST http://127.0.0.1:8000/entries \
     -H "Content-Type: application/json" \
     -d '{"description":"排查登录问题","tags":["infra/login"]}'
  • 查询本周条目（REST）：
    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。

相关 MCP