使用说明
📋 AGC Todo MCP服务器
使用Claude Desktop实现智能待办事项管理的强大模型上下文协议（MCP）服务器
通过智能列表、自然语言处理和无缝的Claude集成来改变您的任务管理。非常适合个人生产力和团队协调。
✨ 特性
🎯 智能任务组织
- 📝 列表：您的个人任务
- 👥 完成：与其他人跟进的任务
- ✅ 完成：已完成任务的存档
🔢 简单任务引用
- 简单的整数ID（1、2、3…）-没有复杂的UUID！
- 自然参考任务： “向任务1添加更新”
📅 智能日期处理
- 自然语言： “明天”, “9月12日”, “今天和明天”
- 智能日期解析和过滤
- 始终知道当前时间和背景
💬 丰富的评论和更新
- 对每个任务添加时间戳注释
- 带有日期的完整评论历史记录
- 任务时间线跟踪
📊 漂亮的桌子展示
所有任务列表都显示在有组织的专业表格中：
ID。描述。所有者。预计到达时间。状态。注释。 |----|-------------|-------|-----|--------|----------| |1 |审查API设计|约翰| 9月12日|待定|3| |2|更新文档|Sarah |Sep 15|正在进行|1|
🚀 快速开始
安装
# Clone the repository
git clone https://github.com/your-username/agc-todo-mcp-server.git
cd agc-todo-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
Claude桌面设置
-
打开克劳德桌面配置：
cd ~/Library/Application\ Support/Claude/ open -a TextEdit claude_desktop_config.json -
添加服务器配置：
{ "mcpServers": { "agc-todo": { "command": "node", "args": ["/path/to/your/agc-todo-mcp-server/build/index.js"] } } } -
重新启动克劳德桌面 你准备好了！ 🎉
📖 详细设置指南： 看 claude-desktop setup.md
💡 示例用法
个人任务管理
🗣️ "Add a todo for me: Complete the quarterly report by Friday"
🗣️ "What are my tasks for today and tomorrow?"
🗣️ "Add an update to task 3: Making good progress, 80% done"
🗣️ "Mark task 1 as complete"
团队协调
🗣️ "Follow up with Sarah about the API review by next Tuesday"
🗣️ "Who should I follow up with?"
🗣️ "What are Sarah's tasks for this week?"
🗣️ "Search for tasks assigned to the development team"
任务跟踪
🗣️ "View task 2" → Shows complete history with timestamps
🗣️ "Search for tasks containing 'API'"
🗣️ "What are all my completed tasks?"
🛠️ 配置选项
默认设置
任务存储在 ./todos.json 在您的服务器目录中。
自定义位置
选择您喜欢的存储位置：
方法1：命令行参数
{
"mcpServers": {
"agc-todo": {
"command": "node",
"args": [
"/path/to/agc-todo-mcp-server/build/index.js",
"--todo-file",
"/path/to/your/custom-todos.json"
]
}
}
}
方法2：环境变量
{
"mcpServers": {
"agc-todo": {
"command": "node",
"args": ["/path/to/agc-todo-mcp-server/build/index.js"],
"env": {
"TODO_FILE_PATH": "/path/to/your/custom-todos.json"
}
}
}
}
🎮 可用命令
| 命令 | 描述 | 示例 |
|---|---|---|
add_todo |
创建新任务 | “为我添加一切……” |
get_my_tasks |
查看您的DO列表 | “我的任务是什么？” |
get_follow_ups |
查看待办事项列表 | “我应该跟谁跟进？” |
search_todos |
搜索所有任务 | “搜索John的任务” |
update_todo |
添加评论/更新 | “更新任务1:即将完成” |
mark_complete |
完成任务 | “将任务3标记为已完成” |
view_task |
详细任务视图 | “显示任务2” |
📁 数据结构
{
"do": [
{
"id": 1,
"description": "Complete project proposal",
"owner": "current-user",
"eta": "2024-09-15T00:00:00Z",
"status": "pending",
"comments": [
{
"timestamp": "2024-09-10T10:30:00Z",
"text": "Started initial draft"
}
],
"createdAt": "2024-09-10T09:00:00Z",
"updatedAt": "2024-09-10T10:30:00Z"
}
],
"getDone": [...],
"completed": [...],
"nextId": 4
}
🔧 发展
技术栈
- TypeScript -类型安全开发
- Node.js -运行时环境
- MCP-SDK -模型上下文协议集成
- 自然语言处理 -智能日期解析
脚本
npm run build # Build TypeScript to JavaScript
npm start # Start the MCP server
npm run dev # Development mode with auto-reload
项目结构
agc-todo-mcp-server/
├── src/
│ ├── index.ts # Main MCP server
│ ├── todoManager.ts # Core todo operations
│ ├── dateUtils.ts # Smart date handling
│ └── types.ts # TypeScript definitions
├── build/ # Compiled JavaScript
├── claude-desktop-setup.md
└── README.md
🤝 贡献
我们热爱贡献！无论是：
- 🐛 错误报告 -发现问题？让我们知道！
- 💡 功能请求 -有主意吗？分享！
- 🔧 代码贡献 -PR欢迎！
- 📖 文档 -帮助他人开始
入门指南
- 分叉存储库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
📝 示例提示
日常生产力
- “为我添加待办事项：在下午2点前查看并回复团队电子邮件”
- “我今天的任务是什么？”
- 向任务5添加更新：已联系客户端，等待反馈
项目管理
- “在周四之前与Alex跟进数据库迁移事宜”
- “搜索与移动应用程序项目相关的任务”
- “将API文档任务标记为完成”
团队协调
- “本周我需要跟进哪些任务？”
- “添加待办事项：为下周一的项目启动安排团队会议”
- “查看任务7” （显示完整的历史和时间线）
状态更新
- 更新任务3：在支付系统中遇到错误，正在调查
- 向任务1添加更新：初稿已完成，需要审查
- “我上周完成的任务都是什么？”
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙋♂️ 支持
由以下材料制成❤️ 面向生产力爱好者
⭐ 标记此回购 如果你觉得它有用的话！
