Todo App using MCP Server

A simple Todo application enhanced with natural language processing using the Google Gemini API, MongoDB for persistence, and MCP (Model Context Protocol) for real-time updates via Server-Sent Events (SSE). Built using a modular MVC architecture with Express.js.

---

Features

• Add todos using natural language (e.g., "Add a task to buy milk")
• List todos (optionally include completed ones)
• Mark todos as complete using their MongoDB ID
• Delete todos by their MongoDB ID
• Receive real-time updates using Server-Sent Events (SSE) with MCP

---

Tech Stack

• Node.js: Server runtime
• Express.js: Routing and middleware
• MongoDB (Atlas): Cloud-based NoSQL database
• Mongoose: ODM for MongoDB
• Google Gemini API: Handles natural language command interpretation
• @modelcontextprotocol/sdk: For MCP integration and SSE
• dotenv: For managing environment variables

---

Prerequisites

• Node.js (v18 or higher)
• MongoDB Atlas cluster (credentials required)
• Google Gemini API Key (available from Google AI Studio)

---

Installation

1. Clone the repository

   git clone https://github.com/theatulanand/to-do-mcp-server.git
   cd todo-mcp-single
   

2. Install dependencies

   npm install
   

3. Set up environment variables

   Create a .env file in the root directory:

   PORT=3000
   MONGO_URI=URI
   GEMINI_API_KEY=
   

---

Running the App

Start the server:

npm start

You should see:

Connected to MongoDB with Mongoose
Server running on http://localhost:3000

To stop the server, press Ctrl + C.

---

How to Use

Send a POST request to /api/command with a JSON body:

{ "command": "Add a task to buy milk" }

Example Commands

• Add:

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Add a task to buy milk"}'
  

• List:

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos"}'
  

• Complete:

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Complete todo with ID some_mongodb_id"}'
  

• Delete:

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Delete todo with ID some_mongodb_id"}'
  

• List including completed:

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos including completed"}'
  

---

Real-time Updates (SSE)

Connect to /sse to receive live updates. (Requires MCP-compatible client.)

---

Project Structure

todo-mcp-single/
├── models/           # Mongoose schemas
│   └── Todo.js
├── controllers/      # Business logic
│   └── todoController.js
├── routes/           # API routes
│   └── todoRoutes.js
├── utils/            # Utility functions (e.g., Gemini integration)
│   └── gemini.js
├── .env              # Environment configuration
└── server.js         # App entry point

---

Troubleshooting

• MongoDB Connection Failed: Check MONGO_URI and IP whitelist in Atlas.
• Gemini API Errors: Validate API key and network access to generativelanguage.googleapis.com.
• Unrecognized Commands: Check Gemini raw output in logs for debugging.

---