Skip to content

paramarshlabs/mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

🧠 Task Manager MCP Server

Link: https://amanxai.com/2026/02/22/build-your-first-mcp-server-in-python/

A simple Model Context Protocol (MCP) server built with Python that allows AI assistants like Claude Desktop, Cursor, or any MCP-compatible client to manage a task list through natural language.

This project demonstrates how Large Language Models can securely interact with external tools by exposing task management capabilities through MCP.


🚀 What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI models to connect with external applications, tools, and data sources using a common interface.

Instead of creating custom integrations for every AI application, developers can build an MCP server once and make it accessible to any MCP-compatible client.

The MCP ecosystem consists of three main components:

  • MCP Host — The application where users interact with the AI (Claude Desktop, Cursor, etc.)
  • MCP Client — Handles communication between the AI model and the MCP server
  • MCP Server — Exposes tools, resources, and prompts that the AI can access

🏗️ Architecture

User
  |
  v
AI Assistant (MCP Host)
  |
  v
MCP Client
  |
  v
Task Manager MCP Server
  |
  v
In-memory Task Storage

✨ Features

🔧 Tools

The MCP server exposes the following tools:

  • ➕ Add new tasks
  • 📋 View all existing tasks
  • 🗑️ Remove completed or unnecessary tasks
  • ✏️ Update task information

📚 Resources

Read-only data that can provide additional context to the AI.

📝 Prompts

Reusable templates that help guide the AI in interacting with the MCP server.


🛠️ Tech Stack

  • Python 3
  • Model Context Protocol (MCP)
  • MCP Python SDK

📦 Installation

1. Clone the repository

git clone https://github.com/your-username/task-manager-mcp.git
cd task-manager-mcp

2. Create a virtual environment

python -m venv .venv

Activate the environment:

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

▶️ Running the MCP Server

Start the server:

python server.py

For development and testing using MCP Inspector:

mcp dev server.py

💬 Example Interaction

User:

Add "Finish the MCP project README" to my tasks.

AI Assistant:

✅ Task added successfully.

User:

What tasks do I have pending?

AI Assistant:

You have 1 pending task:

  • Finish the MCP project README

🔮 Future Improvements

  • Persistent storage with SQLite or PostgreSQL
  • Task priorities and due dates
  • User authentication
  • Calendar integrations
  • Notifications and reminders

📄 License

This project is licensed under the MIT License.

About

learning mcp

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages