task-mcp-server
Task API Server is a Model Context Protocol (MCP) server implementation for managing tasks in TypeScript. It provides both command-line and web-based interfaces for comprehensive task management operations. Its features include task listing, creation, updating, deletion, and robust error-handling, supported by extensive testing and quality assurance protocols.
Overview
Task API Server is a Model Context Protocol (MCP) implementation for task management, built in TypeScript. It serves as both a reference implementation and a functional server, with two modes of operation: STDIO for command-line applications and HTTP+SSE for web-based interfaces. The server supports complete task management operations, including listing, creating, updating, and deleting tasks, along with extensive validation and error handling.
Features
-
Task Management Operations:
- List, create, update, delete tasks with customizable properties
-
Dual Interface Modes:
- STDIO protocol for CLI and AI integration
- HTTP+SSE protocol for web access
-
MCP Protocol Implementation:
- Full MCP implementation with resources and tools for task operations
-
Quality Assurance:
- Comprehensive test suite and automatic server shutdown after tests
Getting Started
- Prerequisites: Node.js 16.x or higher, npm or pnpm
- Installation: Clone repository, install dependencies, create
.env
file - Running the Server: Utilize CLI for STDIO mode or web interface for HTTP mode
- Testing: Run npm tests to verify functionality
Environment Variables
Variable | Description |
---|---|
TASK_MANAGER_API_BASE_URL | External Task API URL |
TASK_MANAGER_API_KEY | API key |