To Do List MCP Server

🚀 To-Do List MCP Server

A simple to-do list manager implemented based on the Model Context Protocol (MCP), providing basic CRUD operations through MCP tools.

🚀 Quick Start

The To-Do List MCP Server is a straightforward application that enables users to manage their to-do items efficiently. It leverages the Model Context Protocol (MCP) to provide a seamless experience for handling to-do tasks.

✨ Features

• Add New To-Do Items: Easily add new tasks to your to-do list.
• View All To-Do Items: Get a comprehensive overview of all your tasks.
• Delete To-Do Items by ID: Remove specific tasks based on their unique identifiers.
• Type-Safe Operations with Zod: Ensure data integrity through Zod validation.
• Simple In-Memory Storage: Keep your data in memory for quick access.
• Stdio Transmission for Easy Integration: Facilitate seamless integration with other systems.

📦 Installation

npm install @modelcontextprotocol/sdk zod

💻 Usage Examples

Basic Usage

// Add a new to-do item
await client.callTool({
    name: "add-todo",
    arguments: { text: "Buy groceries" }
});

// Get all to-do items
await client.callTool({ name: "get-todos" });

// Delete a to-do item
await client.callTool({
    name: "remove-todo",
    arguments: { id: 1 }
});

How to Run the Server

npm run start

Available Tools

1. add-todo: Add a new to-do item.

   • Parameters: {text: string}
   • Returns: A success message and the assigned ID.

2. get-todos: Retrieve all to-do items.

   • Returns: A formatted list of to-do items or an empty state message.

3. remove-todo: Delete a to-do item.

   • Parameters: {id: number}
   • Returns: A success message if the deletion is successful, or an error if the ID is not found.

🔧 Technical Details

• Use the MCP Server SDK: Ensure compliance with the MCP protocol.
• Implement Tool Mode: Perform operations in a tool-based manner.
• Use Stdio Transmission for Communication: Establish communication channels.
• Maintain State in Memory: Keep it simple by storing data in memory.

📚 Testing

Test the server using an MCP client (e.g., claude):

1. Start the server.
2. Connect using the MCP checker.
3. Test each tool individually.
4. Verify the responses and error handling.