Task MCP Server

🚀 タスクAPIインターフェースのタスクマネージャ実装

このプロジェクトは、MCPプロトコルに基づくタスクマネージャです。2種類の異なるインターフェース（コマンドラインインターフェースとネットワークインターフェース）を通じて、タスクの管理と操作をサポートしています。ユーザーはこれを使って、タスクの作成、更新、照会、削除を行うことができます。

✨ 主な機能

• タスク作成：ユーザーが新しいタスクを追加できます。
• タスク照会：状態、カテゴリ、または優先度に基づいてタスクリストをフィルタリングできます。
• タスク更新：既存のタスクの詳細情報を変更できます。
• タスク削除：不要になったタスクを削除できます。

📦 インストール

前提条件

• Node.js (推奨バージョン：14.0+)
• npm/yarnパッケージ管理ツール
• 環境変数設定ファイル（.env）

インストール手順

1. Node.jsとnpmをダウンロードしてインストールします。
2. プロジェクトリポジトリをローカルにクローンします。

   git clone https://github.com/yourusername/mcp-task.git
   

3. プロジェクトディレクトリに移動します。

   cd mcp-task
   

4. 依存関係をインストールします。

   npm install
   

環境変数設定

プロジェクトの.envファイルを編集し、以下の内容を追加します。

TASK_MANAGER_API_BASE_URL=あなたのタスクAPIアドレス  # 必須入力
TASK_MANAGER_API_KEY=あなたのAPIキー         # 必須入力
TASK_MANAGER_HTTP_PORT=3000              # オプション、デフォルトは3000
PORT=その他のポート名                       # オプション、TASK_MANAGER_HTTP_PORTより優先度が高い

💻 使用例

基本的な使用法

コマンドラインインターフェース (STDIO)

ターミナルで使用するのに適しており、迅速なタスク管理操作が可能です。例えば：

node index.js --list  # すべてのタスクをリスト表示
node index.js --create "プロジェクトレポートを完成させる"  # 新しいタスクを作成

ネットワークインターフェース (HTTP + SSE)

HTTPプロトコルとSSE（サーバー送信イベント）を通じたやり取りをサポートしており、Webアプリケーションの構築に適しています。例えば：

// fetch APIを使用してタスクを作成
fetch('http://localhost:3000/api/tasks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    task: "プロジェクトレポートを完成させる"
  })
});

高度な使用法

コマンドラインツール (STDIO)

タスクの一覧表示 (listTasks)

node index.js --list [--status 状態] [--category カテゴリ] [--priority 優先度]

• --status：オプション、状態には「未完成」、「進行中」、「完了」が含まれます。
• --category：オプション、カテゴリには「仕事」、「学習」、「生活」が含まれます。
• --priority：オプション、優先度には「低」、「中」、「高」が含まれます。

タスクの作成 (createTask)

node index.js --create <タスク名>

タスクの更新 (updateTask)

node index.js --update <タスクID> [--status 状態] [--category カテゴリ] [--priority 優先度]

タスクの削除 (deleteTask)

node index.js --delete <タスクID>

ネットワークインターフェース (HTTP + SSE)

すべてのAPIリクエストは認証が必要です。以下は一般的なAPIエンドポイントです。

• タスクの作成：

  POST /api/tasks
  Content-Type: application/json
  
  {
    "task": "プロジェクトレポートを完成させる"
  }
  

• タスクの照会：

  GET /api/tasks?status=未完成&category=仕事&priority=高
  

• タスクの更新：

  PUT /api/tasks/{taskId}
  Content-Type: application/json
  
  {
    "status": "進行中",
    "category": "仕事",
    "priority": "高"
  }
  

• タスクの削除：

  DELETE /api/tasks/{taskId}
  

📚 ドキュメント

プロジェクト構造

mcp-task/
├── dist/               # コンパイル後のJavaScriptファイルディレクトリ
├── src/                # TypeScriptソースコードディレクトリ
│   ├── index.ts        # STDIOサーバーのエントリーファイル
│   ├── http-server.ts  # HTTP + SSEサーバーのエントリーファイル
│   └── test-client.ts  # テストクライアントの実装
├── .env                # 環境変数設定ファイル
├── package.json       # プロジェクトの依存関係管理ファイル
├── tsconfig.json      # TypeScriptコンパイラの設定ファイル
└── README.md          # プロジェクトドキュメント

開発ガイド

1. 開発環境の起動：

   npm run watch
   

   これにより、ソースコードファイルがリアルタイムで監視され、自動的にコンパイルされます。

2. テストの実行：

   npm test
   

   すべての事前定義されたテストケースが実行され、機能が正常に動作することが確認されます。

3. プロジェクトのビルド：

   npm run build
   

   最適化された本番用バージョンのファイルがdist/ディレクトリに生成されます。

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。

謝辞

以下のプロジェクトの貢献に感謝します。

• MCPプロトコル - 通信の標準を提供しています。
• TypeScript - 強い型付けのコードを記述するために使用されています。