# Tasks MCP Server
An MCP (Model Context Protocol) server for task management with pluggable storage backends.
## Project Structure
```
tasks-mcp-server/
├── package.json # Bun project config with MCP SDK dependencies
├── tsconfig.json # TypeScript configuration
└── src/
├── index.ts # Main MCP server entry point
├── types.ts # Task types and Zod schemas
└── services/
├── TaskService.ts # Abstract TaskService interface
└── InMemoryTaskService.ts # In-memory implementation
```
## Installation
```bash
bun install
```
## Building
```bash
bun run build
```
## Usage
```bash
# Start with default in-memory service
bun run start
# Specify service implementation
bun run start -- --service memory
# Show help
bun run start -- --help
```
## Abstract TaskService Interface
The `TaskService` interface (`src/services/TaskService.ts`) defines the contract for task storage implementations:
- `list(status?)` - List all tasks, optionally filtered by status
- `get(id)` - Get a single task by ID
- `create(input)` - Create a new task
- `complete(id)` - Mark task as completed
- `delete(id)` - Delete a task
### Available Implementations
**InMemoryTaskService** (`src/services/InMemoryTaskService.ts`):
- Stores tasks in a Map
- Generates sequential IDs (`task-1`, `task-2`, etc.)
- Tasks persist only during server runtime
## MCP Tools
| Tool | Description |
|------|-------------|
| `tasks_list` | List all tasks (supports filtering by status and markdown/json output) |
| `tasks_create` | Create a new task with title and optional description |
| `tasks_complete` | Mark a task as completed by ID |
| `tasks_delete` | Delete a task permanently by ID |
## MCP Resources
| Resource | Description |
|----------|-------------|
| `task://{id}` | Access individual tasks by ID (template resource) |
| `task://list` | List all tasks as JSON (static resource) |
## Integration
The server uses stdio transport, making it suitable for integration with MCP clients like Claude Desktop or other MCP-compatible applications.
### Claude Desktop Configuration
Add to your Claude Desktop config:
```json
{
"mcpServers": {
"tasks": {
"command": "bun",
"args": ["run", "/path/to/tasks-mcp-server/dist/index.js", "--service", "memory"]
}
}
}
```
