Valkey MCP Task Management Server

Features

• Plan management (create, read, update, delete)
• Task management (create, read, update, delete)
• Task ordering and prioritization
• Status tracking for tasks
• Notes support with Markdown formatting for both plans and tasks
• MCP server for AI agent integration
• Supports STDIO, SSE and Streamable HTTP transport protocols
• Docker container support for easy deployment

Architecture

The system is built using:

• Go: For the backend implementation
• Valkey: For data persistence
• Valkey-Glide v2: Official Go client for Valkey
• Model Context Protocol: For AI agent integration

Quick Start# Docker Deployment

The MCP server is designed to run one protocol at a time for simplicity. By default, all protocols are disabled and you need to explicitly enable the one you want to use.

Prerequisites

1. Create a named volume for Valkey data persistence:

docker volume create valkey-data

Running with SSE (Recommended for most use cases)

docker run -d --name valkey-mcp \
- p 8080:8080 \
- p 6379:6379 \
- v valkey-data:/data \
- e ENABLE_SSE=true \
ghcr.io/jbrinkman/valkey-ai-tasks:latest

Running with Streamable HTTP

docker run -d --name valkey-mcp \
- p 8080:8080 \
- p 6379:6379 \
- v valkey-data:/data \
- e ENABLE_STREAMABLE_HTTP=true \
ghcr.io/jbrinkman/valkey-ai-tasks:latest

Running with STDIO (For direct process communication)

docker run -i --rm --name valkey-mcp \
- v valkey-data:/data \
- e ENABLE_STDIO=true \
ghcr.io/jbrinkman/valkey-ai-tasks:latest

MCP API Reference

The MCP server supports two transport protocols: Server-Sent Events (SSE) and Streamable HTTP. Each protocol exposes similar endpoints but with different interaction patterns.

Health Check

• GET /health: Returns server health status

Available Functions## Plan Management

• create_plan: Create a new plan
• get_plan: Get a plan by ID
• list_plans: List all plans
• update_plan: Update an existing plan
• delete_plan: Delete a plan by ID

Task Management

• create_task: Create a new task in a plan
• get_task: Get a task by ID
• list_tasks_by_plan: List all tasks in a plan
• update_task: Update an existing task
• delete_task: Delete a task by ID

License

This project is licensed under the BSD-3-Clause License.