M
MCP&Agent挑战赛_Datawhale_gravitas_计划助手
gravitasust/todo_test_gravitas_0x01
0 Stars
351 次浏览
更新于 2026-08-23
本项目是一个基于 Python 的个人待办事项管理 MCP Server，帮助用户高效管理每日任务和个人信息。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"personal_todo_assistant": {
"args": [
"app.py"
],
"command": "python",
"env": {
"GRADIO_SERVER_NAME": "0.0.0.0",
"GRADIO_SERVER_PORT": "15181",
"PYTHONPATH": "."
}
}
}
}服务介绍
个人待办事项助手
本项目是一个基于 Python 的个人待办事项管理 MCP Server，帮助用户高效管理每日任务和个人信息。
目录结构
todo_test_gravitas_0x01/
├── .gitattributes
├── .python-version
├── personal_todo_assistant.py
├── pyproject.toml
├── README.md
├── todo_history.csv
├── user_info.json
├── uv.lock
主要功能
- 初始化待办事项历史文件
- 获取和更新用户信息（如年龄、习惯、专长、当前工作、知识领域、自控力、专注力等）
- 添加、删除、修改今日待办事项
- 查询今日待办事项列表
- 查询最近一周的待办事项历史
快速开始
1. 服务配置
{
"mcpServers": {
"personal_todo_assistant": {
"command": "python",
"args": ["app.py"],
"env": {
"PYTHONPATH": ".",
"GRADIO_SERVER_NAME": "0.0.0.0",
"GRADIO_SERVER_PORT": "15181"
}
}
}
}
环境变量
PYTHONPATH：设置为当前目录，确保 Python 能正确导入模块。GRADIO_SERVER_NAME：设置为0.0.0.0，允许外部访问 Gradio 界面。GRADIO_SERVER_PORT：设置为7860，指定 Gradio 服务的端口。
2. 安装依赖
uv sync
2. 主要文件说明
personal_todo_assistant.py：主程序，包含所有核心功能。todo_history.csv：存储每日待办事项历史。user_info.json：存储用户个人信息。pyproject.toml：项目依赖配置文件。
接口说明
主要功能均以工具函数形式实现，部分示例：
- 初始化历史文件：
init_history() - 获取用户信息：
get_user_info(age, habits, strengths, current_work, knowledge, self_control, focus) - 更新用户信息：
update_user_info(keys, values) - 获取今日待办事项：
get_todo_list_today() - 添加今日待办事项：
add_todo_item_today(item_name, item_status, item_priority, item_category, deadline, estimated_time, notes) - 删除今日待办事项：
delete_todo_item_today(item_name) - 修改今日待办事项：
modify_todo_item_today(item_name, keys, values) - 获取一周历史：
get_todo_history()
注意事项
- 用户信息仅需初始化一次，后续可通过更新接口修改。
- 删除操作为逻辑删除，不会物理移除数据。
- 所有数据均以 CSV/JSON 文件本地存储。
许可证
MIT Licence
