To Do List MCP Server

To Do リスト MCP サーバー

基本的な CRUD 操作を MCP ツール経由で提供する、シンプルな To Do リストマネージャーの Model Context Protocol（MCP）実装です。

特長

• 新しい To Do 項目の追加
• すべての To Do 項目の表示
• ID による To Do 項目の削除
• Zod バリデーションによる型安全な操作
• シンプルさを重視したインメモリストレージ
• 簡単に統合できる Stdio トランスポート

インストール

npm install @modelcontextprotocol/sdk zod

使い方

サーバーを実行します。

npm run start

利用可能なツール：

1. add-todo：新しい To Do 項目を追加します

• パラメーター：{text: string}
• 割り当てられた ID を含む成功メッセージを返します

2. get-todos：すべての To Do 項目を取得します

• すべての項目の整形済みリスト、または空の状態を示すメッセージを返します

3. remove-todo：To Do 項目を削除します

• パラメーター：{id: number}
• 削除成功時は成功メッセージを返し、ID が見つからない場合はエラーを返します

使用例

// Add a new todo
await client.callTool({
    name: "add-todo",
    arguments: { text: "Buy groceries" }
});

// Get all todos
await client.callTool({ name: "get-todos" });

// Remove a todo
await client.callTool({
    name: "remove-todo",
    arguments: { id: 1 }
});

実装の詳細

• プロトコルに準拠するため、MCP Server SDK を使用します
• 操作にはツールパターンを実装します
• 通信には Stdio トランスポートを使用します
• シンプルさを重視し、状態をメモリ内に保持します

テスト

claude などの MCP クライアントを使用してサーバーをテストします。

1. サーバーを実行します
2. MCP Inspector に接続します
3. 各ツールを個別にテストします
4. 応答とエラー処理を確認します