# 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:

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

---

## 2. list_tasks

Returns all available tasks.

Example response:

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

---

## 3. update_task

Updates an existing task.

Example:

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

---

## 4. complete_task

Marks a task as completed.

Example:

```json
{
  "id": 1
}
```

---

## 5. delete_task

Deletes a task using its ID.

Example:

```json
{
  "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:

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

Navigate into project:

```bash
cd mini-task-mcp
```

Install dependencies:

```bash
npm install
```

---

# ▶️ Running the Project

## Build TypeScript

```bash
npm run build
```

---

## Start MCP Server

```bash
npm start
```

---

## Run MCP Client

```bash
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