TypeScript で書かれたタスク管理 API のモデルコンテキストプロトコル(MCP)の実装。 本プロジェクトは、参照実装と機能的なタスク管理サーバーの両方で動作します。

概要

このMCPサーバーは外部タスクAPIサービスに接続し、タスク管理のための標準化されたインターフェイスを提供します。 2つのランタイムモードをサポートしています。

1.STDIOモード:CLIベースのアプリケーションとAIエージェントの標準的な入力/出力通信 2.HTTP+SSE Mode:ブラウザとHTTPベースのクライアントのサーバー送信イベントでWebアクセス可能なサーバー

サーバは、タスク管理操作、広範な検証、および堅牢なエラー処理の完全なセットを提供しています。

##特徴

• タスク管理操作:
• フィルタリング機能で既存のタスクをリスト
• カスタマイズ可能なプロパティで新しいタスクを作成
• タスクの詳細を更新(説明、ステータス、カテゴリ、優先順位)
• 完了または不要でタスクを削除

-デュアルインターフェースモード:

• コマンドラインとAIエージェントの統合のためのSTDIOプロトコルサポート

• ブラウザベースのアクセスのためのWebインターフェイスを備えたHTTP + SSEプロトコル

• MCPプロトコルの実装:

• モデルコンテキストプロトコルの完全な実装

Task API Server - MCP TypeScript Implementation

A Model Context Protocol (MCP) implementation for Task Management API written in TypeScript. This project serves as both a reference implementation and a functional task management server.

Overview

This MCP server connects to an external Task API service and provides a standardized interface for task management. It supports two runtime modes:

1. STDIO Mode: Standard input/output communication for CLI-based applications and AI agents
2. HTTP+SSE Mode: Web-accessible server with Server-Sent Events for browser and HTTP-based clients

The server offers a complete set of task management operations, extensive validation, and robust error handling.

Features

• Task Management Operations:

  • List existing tasks with filtering capabilities
  • Create new tasks with customizable properties
  • Update task details (description, status, category, priority)
  • Delete tasks when completed or no longer needed

• Dual Interface Modes:

  • STDIO protocol support for command-line and AI agent integration
  • HTTP+SSE protocol with web interface for browser-based access

• MCP Protocol Implementation:

  • Complete implementation of the Model Context Protocol
  • Resources for task data structures
  • Tools for task operations
  • Error handling and informative messages

• Quality Assurance:

  • Comprehensive test client for validation
  • Automatic server shutdown after tests complete
  • Detailed validation of API responses

Getting Started

Prerequisites

• Node.js 16.x or higher
• npm or pnpm package manager

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/mcp-template-ts.git
   cd mcp-template-ts
   

2. Install dependencies:

   npm install
   

   or using pnpm:

   pnpm install
   

3. Create an .env file with your Task API credentials:

   TASK_MANAGER_API_BASE_URL=https://your-task-api-url.com/api
   TASK_MANAGER_API_KEY=your_api_key_here
   TASK_MANAGER_HTTP_PORT=3000
   

4. Build the project:

   npm run build
   

Running the Server

STDIO Mode (for CLI/AI integration)

npm start

or

node dist/index.js

HTTP Mode (for web access)

npm run start:http

or

node dist/http-server.js

By default, the HTTP server runs on port 3000. You can change this by setting the TASK_MANAGER_HTTP_PORT environment variable.

Testing

Run the comprehensive test suite to verify functionality:

npm test

This will:

1. Build the project
2. Start a server instance
3. Connect a test client to the server
4. Run through all task operations
5. Verify correct responses
6. Automatically shut down the server

Using the MCP Client

STDIO Client

To connect to the STDIO server from your application:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";