todo-mcp-server

TodoMCPAppServer

TodoアプリケーションのためのMCPサーバー実装。YAMLファイルによるタスク永続化とstdioトランスポートを使用します。

機能

• TODOアイテムの作成、読み取り、更新、削除（CRUD）機能
• YAMLファイルによるデータ永続化
• stdio（標準入出力）を使用したMCPトランスポート
• リアルタイム更新
• 各TODOアイテムは以下のフィールドを持ちます：
  • id (string): 一意な識別子（UUID）
  • title (string): タスクのタイトル
  • completed (boolean): タスクの完了状態
  • description (string, 任意): タスクの詳細説明
  • dueDate (string, 任意): タスクの期限（YYYY-MM-DD形式）
  • createdAt (string): 作成日時（ISO8601形式）
  • updatedAt (string): 更新日時（ISO8601形式）

要件

• Node.js v22以上

インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/yaml-todo.git
cd yaml-todo

# 依存関係をインストール
npm install

# TypeScriptをビルド
npm run build

使い方

1. ビルド

npm run build

2. MCPサーバの設定を各MCPクライアントの設定に追加します。

{
    "servers": {
        "todo-mcp-server": {
            "type": "stdio",
            "command": "node",
            "args": [
                "path/to/dist/index.js", // MCPサーバのエントリポイント(ビルド後のファイル)
                "path/to/data.yaml" // TODOリストを保存するYAMLファイルのパス
            ]
        }
    }
}