task-mcp-server by tatasadi - MCP Server

Task MCP Server

A Model Context Protocol (MCP) server for task management that provides AI assistants with task creation, listing, and status update capabilities.

Overview

This MCP server implements a simple in-memory task management system that can be integrated with AI assistants like Claude Desktop. It provides three core tools for managing tasks through the Model Context Protocol.

Features

Create Task: Create new tasks with title, description, and status
List Tasks: View all existing tasks with their details
Update Task Status: Change task status between pending, in-progress, and completed
Docker Integration: Fully containerized for easy deployment and isolation
MCP Compatible: Works with any MCP-compatible client

Available Tools

`create-task`

Creates a new task in the task manager.

Parameters:

title (string): Task title
description (string): Task description
status (enum): Task status - "pending", "in-progress", or "completed" (default: "pending")

`list-tasks`

Lists all tasks currently stored in the task manager.

Parameters: None

`update-task-status`

Updates the status of an existing task.

Parameters:

id (string): Task ID
status (enum): New status - "pending", "in-progress", or "completed"

Getting Started with Docker MCP

Prerequisites

Docker installed on your system
Docker Desktop with MCP Toolkit extension (recommended)

Method 1: Using Docker MCP Toolkit (Recommended)

Build the Docker image:
```
docker build -t task-mcp-server .
```

Create a custom MCP catalog:

docker mcp catalog create custom-servers

Create catalog configuration file:

cat > /tmp/task-mcp-server-catalog.yaml << EOF
registry:
    task-mcp-server:
        dateAdded: "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
        description: Custom Task MCP Server for task management
        image: task-mcp-server:latest
        metadata:
            category: productivity
            license: ISC
            owner: local
            tags:
                - tasks
                - productivity
                - management
        prompts: 0
        readme: ""
        ref: ""
        resources: {}
        source: ""
        title: Task MCP Server
        type: server
EOF

Add server to your custom catalog:

docker mcp catalog add custom-servers task-mcp-server /tmp/task-mcp-server-catalog.yaml

Verify the server is added:
```
docker mcp catalog show custom-servers
```
Run the MCP gateway:
```
docker mcp gateway run
```

Method 2: Direct Integration with Claude Desktop

Add the following configuration to your Claude Desktop config file (claude_desktop_config.json):

{
	"mcpServers": {
		"task-server": {
			"command": "docker",
			"args": ["run", "--rm", "-i", "task-mcp-server:latest"]
		}
	}
}

Method 3: Direct Docker Run

You can also run the server directly with Docker:

docker run --rm -i task-mcp-server:latest

Development

Local Development Setup

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Run locally:

npm start

// or with mcp inspector
npx @modelcontextprotocol/inspector node dist/server.js

Project Structure

task-mcp-server/
├── server.ts          # Main MCP server implementation
├── package.json       # Node.js dependencies and scripts
├── tsconfig.json      # TypeScript configuration
├── Dockerfile         # Docker container configuration
├── dist/              # Compiled JavaScript output
└── README.md          # This file

Usage Examples

Once integrated with an AI assistant, you can use natural language commands like:

"Create a new task to review the quarterly report"
"List all my current tasks"
"Mark task ABC123 as completed"
"Update the status of my presentation task to in-progress"

Technical Details

Runtime: Node.js 18
Protocol: Model Context Protocol (MCP)
Transport: Standard I/O (stdio)
Storage: In-memory (tasks reset on restart)
Container: Lightweight Docker container based on node:18-slim

Security Features

When using Docker MCP Toolkit:

Runs in isolated container environment
Limited to 1 CPU and 2GB memory by default
No host filesystem access unless explicitly granted
Secure credential management through Docker MCP

Contributing

Fork the repository
Create a feature branch
Make your changes
Build and test with Docker
Submit a pull request

License

ISC License - see package.json for details