Mini Task MCP Server

A simple Model Context Protocol (MCP) project built with TypeScript and Node.js.

This project demonstrates how an MCP Client communicates with an MCP Server and uses MCP tools to manage tasks through a standardized protocol.

---

🚀 Features

• MCP Server implementation
• MCP Client implementation
• STDIO transport communication
• Task management system
• Create new tasks
• View all tasks
• Update existing tasks
• Complete tasks
• Delete tasks
• JSON file-based storage
• Type-safe development using TypeScript

---

🛠️ Tech Stack

• Node.js
• TypeScript
• Model Context Protocol SDK
• Zod Validation
• JSON Storage

---

📌 MCP Architecture

              User
                |
                |
          MCP Client
                |
                |
        Model Context Protocol
                |
                |
          MCP Server
                |
                |
        Task Management Tools
                |
                |
            tasks.json

---

🔧 Available MCP Tools

1. add_task

Creates a new task.

Example:

{
  "title": "Complete MCP project",
  "description": "Finish MCP server implementation"
}

---

2. list_tasks

Returns all available tasks.

Example response:

[
  {
    "id": 1,
    "title": "Learn MCP",
    "status": "pending"
  }
]

---

3. update_task

Updates an existing task.

Example:

{
  "id": 1,
  "title": "Updated task title"
}

---

4. complete_task

Marks a task as completed.

Example:

{
  "id": 1
}

---

5. delete_task

Deletes a task using its ID.

Example:

{
  "id": 1
}

---

📂 Project Structure

mini-task-mcp
│
├── src
│   ├── server.ts       # MCP Server implementation
│   └── client.ts       # MCP Client implementation
│
├── tasks.json          # Task storage
│
├── package.json
├── package-lock.json
├── tsconfig.json
├── README.md
└── .gitignore

---

⚙️ Installation

Clone the repository:

git clone https://github.com/yourusername/mini-task-mcp.git

Navigate into project:

cd mini-task-mcp

Install dependencies:

npm install

---

▶️ Running the Project

Build TypeScript

npm run build

---

Start MCP Server

npm start

---

Run MCP Client

npm run client

---

🔄 How MCP Works in This Project

1. The MCP Client sends a request.
2. The MCP Server receives the request.
3. The server identifies the required tool.
4. The selected tool performs the task operation.
5. The result is returned back to the client.

Example:

Client
  |
  | Request: Add Task
  ↓
MCP Server
  |
  | Executes add_task tool
  ↓
tasks.json updated
  |
  ↓
Response returned to Client

---

🎯 Project Purpose

The purpose of this project is to understand the fundamentals of Model Context Protocol (MCP) and how AI applications can securely interact with external tools and data sources.

This mini project demonstrates the foundation required for building AI assistants that can perform real-world operations using connected services.

---

🔮 Future Improvements

• Add SQLite database support
• Add authentication system
• Add REST API support
• Add AI-powered task assistant
• Connect with LLM-based MCP clients
• Add cloud deployment support

---

👨‍💻 Author

Mohd Samir Shaikh

Mini MCP Task Management Project