Next Todo MCP

展示了一个使用Next.JS的MCP服务器支持的简单待办事项应用。仅在本地运行以保持简单（没有真实数据库，没有真实的认证提供者）。

该项目包含

1. 应用程序内嵌的MCP服务器

   • 通过route.ts，将模型上下文协议（MCP）服务器直接嵌入到应用程序中。
   • 轻松扩展或实验MCP工具和端点。

2. 通过API密钥/承载令牌进行的MCP认证

   • 使用API密钥（承载令牌）认证来保护API端点。
   • 示例用户管理和密钥验证在users.dal.ts中。

3. 假数据库及用户管理

   • 用于本地开发的假数据库和用户管理。
   • 可以替换为你喜欢的数据库和认证提供者。

4. 额外功能：超级漂亮的主题切换

   • 使用theme-toggle.tsx享受一个美丽的、动画化的主题切换（亮/暗模式）。
   • 通过prefers-reduced-motion.ts尊重用户的系统偏好设置。

---

开始使用

1. 安装依赖项：

   npm install
   # 或
   yarn install
   

2. 运行开发服务器：

   npm run dev
   # 或
   yarn dev
   

3. 打开浏览器： 访问http://localhost:3000

4. 配置MCP服务器： 打开你的MCP客户端设置（例如Cursor），并添加一个新的MCP服务器如下所示：

   {
       "mcpServers": {
           "todo-mcp": {
               "url": "http://localhost:3000/api/llm/mcp",
               "headers": {
                   "Authorization": "Bearer apikey-1"
               }
           }
       }
   }
   

5. 与你的待办事项列表聊天：让您的MCP客户端添加、列出或删除任务。为了让你大吃一惊，添加一些随机任务，然后要求删除所有这些任务。即使没有明确的端点来执行此操作，MCP客户端仍然可以完成它。

---

自定义

• 在todo.db.ts和users.dal.ts中替换假数据库和用户逻辑，以使用自己的后端或认证。
• 根据需要扩展MCP工具和认证。

---

更多学习资料

• Next.js 文档
• Next.js MCP适配器
• 模型上下文协议（MCP）
• MCP TypeScript SDK