Agc Todo MCP Server

📋 AGC Todo MCP服务器

 ](https://nodejs.org/) 

使用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桌面设置

1. 打开克劳德桌面配置：

   cd ~/Library/Application\ Support/Claude/
   open -a TextEdit claude_desktop_config.json

1. 添加服务器配置：

   {
     "mcpServers": {
       "agc-todo": {
         "command": "node",
         "args": ["/path/to/your/agc-todo-mcp-server/build/index.js"]
       }
     }
   }

1. 重新启动克劳德桌面 你准备好了！ 🎉

📖 详细设置指南： 看 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"
      }
    }
  }
}

🎮 可用命令

📁 数据结构

{
  "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欢迎！
• 📖 文档 -帮助他人开始

入门指南

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

📝 示例提示

日常生产力

• *“为我添加待办事项：在下午2点前查看并回复团队电子邮件”*
• *“我今天的任务是什么？”*
• *向任务5添加更新：已联系客户端，等待反馈*

项目管理

• *“在周四之前与Alex跟进数据库迁移事宜”*
• *“搜索与移动应用程序项目相关的任务”*
• *“将API文档任务标记为完成”*

团队协调

• *“本周我需要跟进哪些任务？”*
• *“添加待办事项：为下周一的项目启动安排团队会议”*
• *“查看任务7”* （显示完整的历史和时间线）

状态更新

• *更新任务3：在支付系统中遇到错误，正在调查*
• *向任务1添加更新：初稿已完成，需要审查*
• *“我上周完成的任务都是什么？”*

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙋‍♂️ 支持

• 📖 文档：查看我们的 安装指南
• 🐛 问题:
• 💬 讨论:

______________________________________________________________________

由以下材料制成❤️ 面向生产力爱好者

⭐ 标记此回购 如果你觉得它有用的话！