任务管理应用

基于Model Context Protocol (MCP)架构的任务管理应用,包含MCP服务器、客户端和Next.js前端,支持任务同步和持久化存储。

  • by abdulmoiz248
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 abdulmoiz248/todo-app

使用说明

Todo应用程序

所有MCP

ToDo MCP是一个围绕 模型上下文协议(MCP) 建筑。它提供了一个用于管理ToDo任务的MCP服务器和客户端的工作实现,以及一个现代化的 Next.js前端 采用TailwindCSS风格。目标是演示MCP服务器和客户端之间的通信,同时以结构化和可扩展的方式同步待办事项。


📂 项目结构

c:/Users/Admin/Desktop/Todo mcp/
├── .gitignore
├── image-1.png              # Screenshots
├── image.png                # Screenshots
├── mcp-client/              # MCP Client implementation
│   ├── .env                  # Environment variables (server URL, etc.)
│   ├── client.py             # MCP client logic
│   ├── main.py               # Client entry point
│   ├── todo.log              # Client logs
│   ├── todos.json            # Local ToDo storage
│   └── __pycache__/          # Compiled Python files
├── mcp-server/              # MCP Server implementation
│   └── server.py             # MCP server entry point
├── README.md                # Root README (this file)
├── todo/                    # Next.js Frontend (ToDoGPT)
│   ├── .gitignore
│   ├─] .next/                # Next.js build (ignored)
│   ├── eslint.config.mjs
│   ├─] next-env.d.ts         # TS env (ignored)
│   ├── next.config.ts
│   ├─] node_modules/         # Dependencies (ignored)
│   ├── package-lock.json
│   ├── package.json
│   ├── postcss.config.mjs
│   ├── public/               # Static assets
│   │   ├── file.svg
│   │   ├── globe.svg
│   │   ├── next.svg
│   │   ├── vercel.svg
│   │   └── window.svg
│   ├── README.md
│   ├── src/
│   │   └── app/
│   │       ├── globals.css   # Tailwind styles
│   │       ├── layout.tsx    # Root layout
│   │       └── page.tsx      # Entry page
│   └── tsconfig.json
├── todo.log                  # Shared/system logs
└── todos.json                # Shared ToDo storage

🚀 特性

  • MCP服务器 (mcp-server/server.py)--使用模型上下文协议提供todo管理端点。
  • MCP客户端 (mcp-client/)--与服务器通信,在本地存储待办事项,并记录操作。
  • Next.js前端(ToDoGPT) --使用动画(Framer Motion)和TailwindCSS管理待办事项的干净GPT风格聊天UI。
  • 永久存储 --todos存储在 todos.json 登录后 todo.log.

🔧 安装和设置

1.克隆存储库

git clone <repo-url>
cd "Todo mcp"

2.运行MCP服务器

cd mcp-server
python server.py

3.运行MCP客户端

cd mcp-client
python main.py

4.运行Next.js前端

cd todo
npm install
npm run dev

访问 http://localhost:3000.


截图


📜 许可证

MIT许可证——免费使用、修改和分发。