To Do List MCP Server

🚀 待办事项リスト MCP サーバー

このプロジェクトは、Model Context Protocol (MCP) をベースにしたシンプルな待办事项マネージャーです。MCP ツールを通じて基本的な CRUD 操作を提供します。

✨ 主な機能

• 新しい待办事项を追加する
• すべての待办事项を表示する
• ID を指定して待办事项を削除する
• Zod を使用した型安全な操作
• シンプルなメモリーストレージ
• 統合が容易な Stdio 伝送

📦 インストール

npm install @modelcontextprotocol/sdk zod

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

npm run start

利用可能なツールは以下の通りです。

1. add-todo：新しい待办事项を追加する

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

2. get-todos：すべての待办事项を取得する

   • フォーマットされた待办事项リストまたは空の状態メッセージを返す

3. remove-todo：待办事项を削除する

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

高度な使用法

// 新しい待办事项を追加する
await client.callTool({
    name: "add-todo",
    arguments: { text: "购买杂货" }
});

// すべての待办事项を取得する
await client.callTool({ name: "get-todos" });

// 待办事项を削除する
await client.callTool({
    name: "remove-todo",
    arguments: { id: 1 }
});

🔧 技術詳細

• MCP サーバー SDK を使用してプロトコル準拠を確保する
• 操作にツールモードを実装する
• Stdio 伝送を使用して通信する
• シンプルさを保つためにメモリ内で状態を維持する

📚 ドキュメント

テスト

MCP クライアント（例：claude）を使用してサーバーをテストするには、以下の手順を実行します。

1. サーバーを起動する
2. MCP チェッカーで接続する
3. 各ツールを個別にテストする
4. 応答とエラー処理を検証する