task-mcp-server

task-mcp-server

5

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

VariableDescription
TASK_MANAGER_API_BASE_URLExternal Task API URL
TASK_MANAGER_API_KEYAPI key