Flutter MCP Task Manager

一个支持 AI 通过 MCP (Model Context Protocol) 协议控制的 Flutter 任务管理应用。

🎯 功能特性

• ✅ AI 可通过 MCP 协议创建、查询、更新、删除任务
• ✅ AI 可控制应用 UI 导航
• ✅ 本地任务存储
• ✅ 优先级管理（低、中、高）
• ✅ 截止日期提醒
• ✅ 任务搜索和筛选
• ✅ 实时 MCP 连接状态显示
• ✅ 统计数据展示

🚀 快速开始

1. 安装依赖

cd /Users/horse/Desktop/mcp实践
flutter pub get

2. 运行应用

# 推荐：在 macOS 桌面运行
flutter run -d macos

# 或其他平台
flutter run -d ios
flutter run -d android
flutter run -d chrome

应用启动后，MCP Server 会自动运行在 http://localhost:8080

✨ 查看详细步骤: QUICKSTART.md

3. 配置 AI 客户端

Claude Desktop 配置

编辑配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "flutter-task-manager": {
      "url": "http://localhost:8080",
      "transport": "http"
    }
  }
}

重启 Claude Desktop 即可开始使用。

🤖 AI 命令示例

启动 Claude Desktop 后，可以使用以下命令：

创建一个高优先级任务：完成季度报告，截止日期是本月底
列出所有待办任务
搜索包含"会议"的任务
将任务 123456 标记为已完成
导航到设置页面

🔧 可用的 MCP 工具

工具	说明	参数
create_task	创建新任务	title, description, priority, dueDate
list_tasks	列出任务	status, limit
update_task	更新任务	taskId, title, status, priority
delete_task	删除任务	taskId
search_tasks	搜索任务	query
navigate_to	UI 导航	screen

📚 文档

• 📘 快速开始指南 - 5 分钟快速上手
• 📗 Claude Desktop 配置 - AI 集成详细说明
• 📙 测试指南 - MCP Server 测试方法
• 📕 项目结构 - 完整文件说明

📱 项目结构

lib/
├── main.dart                    # 应用入口
├── models/
│   └── task.dart               # 任务数据模型
├── services/
│   └── task_service.dart       # 任务业务逻辑
├── mcp/
│   ├── server.dart             # MCP Server 实现
│   ├── tools/
│   │   ├── task_tools.dart     # 任务管理工具
│   │   └── ui_tools.dart       # UI 控制工具
│   └── resources/
│       └── app_resources.dart  # 应用资源
└── ui/
    ├── screens/
    │   ├── home_screen.dart
    │   ├── tasks_screen.dart
    │   ├── calendar_screen.dart
    │   ├── settings_screen.dart
    │   └── profile_screen.dart
    └── widgets/
        └── task_card.dart

🔒 安全性

• 所有敏感操作需要用户确认
• 完整的操作日志记录
• 权限管理系统

🎥 演示

应用界面

• 主页: 显示 MCP 连接状态和功能介绍
• 任务列表: 完整的任务管理界面
• 任务详情: 查看和编辑任务详细信息
• 统计面板: 个人中心显示任务统计

AI 控制示例

用户: 创建一个高优先级任务：完成季度报告，截止日期是 2025-10-25
AI: ✅ 任务创建成功！ID: abc123, 优先级: high

用户: 列出所有待办任务
AI: 找到 3 个任务:
    [ ] 完成季度报告 (high)
    [ ] 团队会议准备 (medium)
    [ ] 代码审查 (low)

用户: 导航到任务列表页面
AI: ✅ 已导航到 tasks 页面

🔒 安全性

项目包含基础的安全机制：

• ✅ 本地数据存储
• ✅ CORS 配置
• ✅ 错误处理
• ⚠️ 生产环境建议添加: 身份验证、权限控制、数据加密

🛠 技术栈

• Flutter - UI 框架
• Dart - 编程语言
• Shelf - HTTP 服务器
• SharedPreferences - 本地存储
• Provider - 状态管理
• MCP - Model Context Protocol

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📝 待办事项

• 添加用户认证
• 实现任务标签功能
• 添加任务提醒通知
• 实现日历视图
• 支持任务附件
• 添加数据导出功能
• 实现多语言支持

📄 许可证

MIT License